Merge branch 'master' into 'master'
[brasero.git] / README
bloba8fd68fe579b36739b33f1ed571dd8ffb073a2f3
1 Brasero is a CD/DVD mastering tool for the GNOME Desktop. It is designed to be simple and easy to use. 
3 Features:
5 Data CD/DVD:
6 - supports edition of discs contents (remove/move/rename files inside directories)
7 - can burn data CD/DVD on the fly
8 - automatic filtering for unwanted files (hidden files, broken/recursive symlinks, files not conforming to joliet standard, ...)
9 - supports multisession
10 - supports joliet extension
11 - can write the image to the hard drive
13 Audio CD:
14 - write CD-TEXT information (automatically found thanks to gstreamer)
15 - supports the edition of CD-TEXT information
16 - can burn audio CD on the fly
17 - can use all audio files handled by GStreamer local installation (ogg, flac, mp3, ...)
18 - can search for audio files inside dropped folders 
19 - can insert a pause
20 - can split a track
22 CD/DVD copy:
23 - can copy a CD/DVD to the hard drive
24 - can copy DVD and CD on the fly
25 - supports single-session data DVD
26 - supports any kind of CD
27 - can copy encrypted Video DVDs (needs libdvdcss)
29 Others:
30 - erase CD/DVD
31 - can save/load projects
32 - can burn CD/DVD images and cue files
33 - song, image and video previewer
34 - device detection thanks to HAL
35 - file change notification (requires kernel > 2.6.13)
36 - supports Drag and Drop / Cut'n'Paste from nautilus (and others apps)
37 - can use files on a network as long as the protocol is handled by gnome-vfs
38 - can search for files thanks to beagle (search is based on keywords or on file type)
39 - can display a playlist and its contents (note that playlists are automatically searched through beagle)
40 - all disc IO is done asynchronously to prevent the application from blocking
41 - Brasero default backend is provided by cdrtools/cdrkit but libburn can be used as an alternative
44 Notes on plugins for advanced users
46 1. configuration
48 From the UI you can only configure (choose to use or not to use mostly) non essential plugins; that is all those that don't burn, blank, or image.
49 If you really want to choose which of the latters you want brasero to use, one simple solution is to remove the offending plugin from brasero plugin directory ("install_path"/lib/brasero/plugins/) if you're sure that you won't want to use it.
50 You can also set priorities between plugins. They all have a hardcoded priority that can be overriden through GSettings.
51 If you set this key to -1 this turns off the plugin.
52 If you set this key to 0 this leaves the internal hardcoded priority - the default that basically lets brasero decide what's best.
53 If you set this key to more than 0 then that priority will become the one of the plugin - the higher, the more it has chance to be picked up.
55 2. additional note
57 Some plugins have overlapping functionalities (i.e. libburn/wodim/cdrecord/growisofs, mkisofs/libisofs/genisoimage); but they don't always do the same things or sometimes they don't do it in the same way. Some plugins have a "speciality" where they are the best. That's why it's usually good to have them all around
58 As examples, from my experience:
59 - growisofs is good at handling DVD+RW and DVD-RW restricted overwrite
60 - cdrdao is best for on the fly CD copying
61 - libburn returns a progress when it blanks/formats
64 Requirements:
65 - gtk+ >= 3.x
66 - gnome 3.x (gio)
67 - gstreamer (>=1.0.0)
68 - libxml2
69 - cdrtools or cdrkit
70 - growisofs
71 - a fairly new kernel (>= 2.6.13 because of inotify) (optional)
72 - cairo
73 - libcanberra
74 - totem (>= 3.0) (optional)
75 - tracker (>= 0.10.0) (optional)
76 - libburn (>=0.4.0) (optional)
77 - libisofs (>=0.6.2) (optional)