Xfce Wiki

Sub domains
 

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision		Previous revision
apps:xfburn:start [2020/08/12 02:34] – created kevinbowenapps:xfburn:start [2023/07/02 08:07] (current) – Update Latest Release section kevinbowen
Line 1: Line 1:
-{{ :apps:xfburn.png?nolink|}} +~~NOTOC~~ 
-====== Xfburn ======+{{ :xfce:xfce.xfburn.png?no link|}} 
 +====== Xfburn - a simple CD/DVD/Blu-ray burning tool======
  
 +  * **[[#Introduction|Introduction]]**
 +  * **[[#Functionality|Functionality]]**
 +  * **[[#Audio CD support details|Audio CD support details]]**
 +  * **[[#Required Packages|Required Packages]]**
 +  * **[[#Debugging|Debugging]]**
 +  * **[[#Future Plans|Future Plans]]**
 +  * **[[#Authors|Authors]]**
 +  * **[[#Latest Release|Latest Release]]**
 +  * **[[#Source Code Repository|Source Code Repository]]**
 +  * **[[#Reporting Bugs|Reporting Bugs]]**
  
-Xfburn is a simple CD/DVD burning tool based on [[http://www.libburnia-project.org|libburnia libraries]]. It can blank CD/DVD(-RW)s, burn and create iso images, audio CDs, as well as burn personal compositions of data to either CD or DVD. It Is stable, and under ongoing development.+----
  
-The current version is **0.6.2**, released on 2020-03-07. This release fixes a number of smaller bugs and uses more modern libraries for improved compatibility with today's software.+===== Introduction =====
  
-For more detailed information please have a look at the README or the NEWS file.+Xfburn is a simple CD/DVD/Blu-ray burning tool based on [[http://libburnia-project.org|libburnia]], which are set of libraries and CLI apps. It can blank/erase rewritable media (CD-RW/DVD-RW), compcreate and burn/write ISO images, create and burn audio CDs, as well as burn personal compositions of data to either CD or DVD.
  
-   * [[https://gitlab.xfce.org/apps/xfburn/-/blob/xfburn-0.6.2/README|README]] 
-   * [[https://gitlab.xfce.org/apps/xfburn/-/blob/xfburn-0.6.2/NEWS|NEWS]] 
  
-  * **[[#Source Code Repository|Source Code Repository]]** +For more detailed information, please have a look at the [[https://gitlab.xfce.org/apps/xfburn/-/blob/master/README.md|README]] or the [[https://gitlab.xfce.org/apps/xfburn/-/blob/master/NEWS|NEWS]] file.
-  * **[[#Reporting Bugs|Reporting Bugs]]** +
-  * **[[#Open Bugs|Open Bugs]]**+
  
-\\  +----
-\\  +
-{{:apps:xfburn-0.4.1.jpg?650|:apps:xfburn-0.4.1.jpg}}+
  
-===== Download ===== +<figure "xfburn dialog"> 
-Sources: +{{:apps:xfburn:xfburn-0.4.1.jpg?350|:apps:xfburn:xfburn-0.4.1.jpg}} 
-   * [[http://archive.xfce.org/src/apps/xfburn/0.6/xfburn-0.6.2.tar.bz2|xfburn-0.6.2.tar.bz2]] +{{:apps:xfburn:xfburn-0.6.2.png?350|:apps:xfburn:xfburn-0.6.2.png}} 
-We recommend to use a packaged version of Xfburn if it is available. Xfburn is packaged for several distributions, for example: +</figure> 
-   * [[http://packages.debian.org/search?keywords=xfburn|Debian]] + 
-   * Gentoo +---- 
-   * [[https://packages.ubuntu.com/search?keywords=xfburn|Ubuntu]] + 
-   * ArchLinux +===== Functionality ===== 
-   * Foresight Linux + 
-And probably many more...+ 
 +Xfburn is still a new program, and does not yet do all common burning related 
 +tasks. 
 + 
 +Currently implemented is: 
 +  * Create data compositions 
 +    * Burn to CD, DVD, or BluRay (BD) 
 +    * Create ISO images 
 +  * Burn ISO images 
 +  * Create and burn audio CDs 
 +  * Blank discs 
 +  * Format and deformat DVD-RW discs 
 + 
 +Xfburn has 3 write modes, which are Auto, TAO (Track-at-Once) and SAO (Session-at-Once). TAO records with the laser stopping after each track is finished and SAO allows the recording over multiple sessions, which will all be read by a computer drive, but CD equipment will only read the first session. At this time there is no multi-session support. ([[https://gitlab.xfce.org/apps/xfburn/-/issues/25|#25]])
  
 +**BurnFree**, like BurnProof and similar technologies, is a feature designed to allow Xfburn to recover if at some point the drive is burning data faster than the application can send it, which decreases the risk of failures.
  
-===== Source code repository ===== +**Stream Recording** disables error management for BD only, which increases 
-[[https://gitlab.xfce.org/apps/xfburn]]+the burning speed. Using it seems to be the best option since discs with 
 +errors tend to fail even when stream recording is disabled.
  
 ---- ----
-===== Reporting Bugs ===== 
-If you are experiencing a bug in ''Xfburn'', your way of helping things getting fixed is to report a bug about it in [[https://gitlab.xfce.org/explore/groups?sort=name_desc|Xfce GitLab]]. Please note that to do this you will need to have / create an account. 
  
-<note important>Before reporting a new bug, please try your best to check if it has already been reported (see the latest reports below). [[https://gitlab.xfce.org/apps/xfburn/-/issues?scope=all&state=all|Click here for a full list of bug reports]].</note>+===== Audio CD support details =====
  
-===== Report a new bug ===== 
  
-If your bug has not been reported before, please [[https://gitlab.xfce.org/apps/xfburn/-/issues/new|submit a new bug report]]. +Included are two transcoders: basic, which just passes through uncompressed 
 +wav data, and gst (gstreamer), which can decode any audio file for which a 
 +gstreamer plugin is present.
  
-When writing your bug report, try to be as descriptive as possible, but avoid verbosity; Mozilla has a nice guide on [[https://developer.mozilla.org/en-US/docs/Mozilla/QA/Bug_writing_guidelines|how to write a bug report]].+==== The basic transcoder ====
  
-For more information, see [[https://docs.xfce.org/contribute/bugs/start|Bug Reporting and Fixing]].+Only CD-quality, uncompressed (PCM) Wave files can be added to an audio 
 +compilation. Use i.e.  your favority audio player with a disc writer output 
 +mode / plugin to decompress your existing audio files. If .wav files are added 
 +to the compilation, their headers get checked to make sure they are of the 
 +right format. Note that this check is not very well tested (in particular it's 
 +not likely to work on big-endian machines like PowerPC). It does not require 
 +any external libraries
  
-**[[https://gitlab.xfce.org/apps/xfburn/-/issues/new|File a new bug or enhancement request]]**+==== The gst transcoder ====
  
 +Based on the gstreamer library, it can decode pretty much any audio content,
 +as long as you have the appropriate plugins installed. Note that by default
 +most distributions do _not_ install these plugins. But a simple search for
 +gstreamer plugins in your package manager should quickly allow you to install
 +them.
 +
 +You can at startup switch between the transcoders, see the command line help
 +for more information.
 +
 +[[|Back to Top]]
 ---- ----
  
-==== Open Bugs ==== +===== Required Packages =====
-Here's a list (updated daily) of open bug reports with the date that bug was reported in parenthesis.+
  
-{{rss>https://gitlab.xfce.org/apps/xfburn/-/issues.atom?state=opened 20 1d date}}+  * libisofs version 0.6.2 or newer 
 +  * libburn version 0.4.2 or newer 
 +    * WARNING: libburn 0.4.2 - 0.5.4 are API compatible, but might trigger an error in libburn's fifo code. 
 +            RECOMMENDED is version 0.5.6 or newer, where the bug was fixed. 
 + 
 +==== Optional, but highly recommended ==== 
 + 
 +  * gstreamer  (1.0+, required for burning audio CDs from compressed music files) 
 +    * gstreamer pbutils (they usually come with gstreamer as far as I know) 
 +    * gstreamer plugins (look for the good, the bad and the ugly plugin pack, most likely you want all of these) 
 + 
 +Let the **highly recommended** part be highlighted once more. Of course 
 +gstreamer will not matter if you do not plan on burning audio CDs, but the 
 +other two libraries will come in handy in almost all situations. 
 + 
 +==== Optional, for maintenance ==== 
 + 
 +  * libxslt (for creating docs) 
 + 
 + 
 +The author works with both hal and thunar-vfs enabled, so there might be the 
 +occasional bug that breaks compilation without these components. Xfburn should 
 +work without these optional components, but it is not well tested at all. 
 +Should something not compile or work as expected, please report a bug, and it 
 +will get fixed. 
 + 
 +[[|Back to Top]] 
 +---- 
 + 
 +===== Debugging ===== 
 + 
 +If xfburn crashes, freezes, or somehow makes no progress for you, then you can 
 +help greatly in debugging the problem. It does require you to build xfburn from 
 +the sources, and to install gdb. If you can handle that, here are the exact 
 +instructions: 
 + 
 +1. Rebuild xfburn with debugging support - grab the sources, and run (you can update  
 +   `-j4` to match your core count): 
 +   ``` 
 +   $ autoconf 
 +   $ ./configure && make clean all -j4 
 +   ``` 
 +2. Enable core dumps, then run xfburn until it hangs, or crashes: 
 +   ``` 
 +   $ ulimit -c unlimited; xfburn/xfburn 2>&1 | tee xfburn.output 
 +   ``` 
 +3. From another terminal, kill xfburn (only if it hasn't crashed already, of coures) 
 +   ``` 
 +   $ kill -SEGV `pidof xfburn`  
 +   ``` 
 +4. Get a backtrace from the coredump: 
 +   ``` 
 +   $ gdb xfburn/xfburn core.32270 --batch -ex 'thread apply all bt' > xfburn.backtrace 
 +   ``` 
 +   (Note that sometimes the core.xxxxxx file is just called core, and that 32270 is 
 +    just an arbitrary number which was the process id - yours will be different) 
 +5. Open up a bug report at our [[:apps:xfburn:bugs|issue tracker]] for xfburn, and add 
 +   both the xfburn.output and the xfburn.backtrace files to it. Done! 
 +   There is no need to attach the core dump, as it is heavily system dependent. 
 + 
 +[[|Back to Top]]    
 + 
 +---- 
 + 
 +===== Future Plans ===== 
 + 
 +Missing functionality that would be nice to have: 
 +  * Save and load compositions ([[https://gitlab.xfce.org/apps/xfburn/-/issues/18|#18]]) 
 +  * Verification ([[https://gitlab.xfce.org/apps/xfburn/-/issues/7|#7]]) 
 +  * Copy discs (needs backend support) ([[https://gitlab.xfce.org/apps/xfburn/-/issues/26|#26]]) 
 +  * Automatic checksum creation 
 +  * Plugin support 
 +  * Multi-session support ([[https://gitlab.xfce.org/apps/xfburn/-/issues/25|#25]]) 
 + 
 +There is no, and never will be, a timeline for these. Let us know if you think 
 +something is missing on this list. If you really need something implemented, 
 +feel free to help us out :-). 
 + 
 +At present development is in maintenance mode, as the author does not have a 
 +lot of time. 
 + 
 +----
  
 ===== Authors ===== ===== Authors =====
Line 65: Line 180:
     * Rene Kjellerup [rk.katana.steel at gmail.com]     * Rene Kjellerup [rk.katana.steel at gmail.com]
  
 +[[|Back to Top]]
 +----
 +
 +===== Latest Release =====
 +{{rss>https://archive.xfce.org/feeds/project/xfburn 1 date 2h}}
 +
 +[[https://gitlab.xfce.org/apps/xfburn/-/blob/master/NEWS|Read the CHANGELOG]]
 +
 +  * **[[https://archive.xfce.org/src/apps/xfburn/|Download current release]]** (link also contains older versions)
 +
 +We recommend to use a packaged version of Xfburn if it is available. Xfburn is packaged for several distributions, for example:
 +   * [[http://packages.debian.org/search?keywords=xfburn|Debian]]
 +   * Gentoo
 +   * [[https://packages.ubuntu.com/search?keywords=xfburn|Ubuntu]]
 +   * ArchLinux
 +   * Foresight Linux
 +And probably many more...
 +
 +[[|Back to Top]]
 +----
 +
 +===== Source Code Repository =====
 +[[https://gitlab.xfce.org/apps/xfburn|]]
 +
 +----
 +===== Reporting Bugs =====
 +  * **[[:apps:xfburn:bugs|Reporting Bugs]]** -- Open bug reports and how to report new bugs
 +
 +Any comments are welcome! We aim to make xfburn a very easily usable program.
 +So if you think something could be implemented differently, feel free to speak
 +up and it will be considered.
 +
 +----
  
 [[|Back To Top]] [[|Back To Top]]
 ---- ----
 [[:start|Back to main Xfce documentation page]] [[:start|Back to main Xfce documentation page]]