1 2soundKonverter is a frontend to various audio converters. 3 4The key features are: 5- Audio conversion 6- ReplayGain calculation 7- CD ripping 8 9Reading and writing tags and covers is supported for many formats, so they are preserved when converting files. 10 11The following backends and formats are supported: 12 13Encoders/Decoders: 14 Encode: Decode: 15faac (aac,m4a) (aac,m4a) 16ffmpeg (ogg vorbis,mp3,flac,wma,aac,m4a,ac3,alac,mp2,amr nb) (ogg vorbis,mp3,flac,wma,aac,ac3,alac,mp2,sad,als,amr nb,amr wb,ape,speex,m4a,mp1,musepack,shorten,tta,wavpack,ra,3gp,rm,avi,mkv,ogv,mpeg,mov,mp4,flv,wmv,rv) 17flac (flac) (flac) 18lame (mp3) (mp2,mp3) 19mplayer (ogg vorbis,mp3,flac,wma,aac,ac3,alac,mp2,sad,als,amr nb,amr wb,ape,speex,m4a,mp1,musepack,shorten,tta,wavpack,ra,3gp,rm,avi,mkv,ogv,mpeg,mov,mp4,flv,wmv,rv) 20neroaac (m4a) (m4a) 21timidity (midi,mod) 22fluidsynth (midi,mod) 23vorbistools (ogg vorbis) (ogg vorbis) 24twolame (mp2) 25musepack (musepack) (musepack) 26flake (flac) 27mac (ape) (ape) 28shorten (shorten) (shorten) 29wavpack (wavpack) (wavpack) 30ttaenc (tta) (tta) 31opustools (opus) (opus) 32speex (speex) (speex) 33sox (ogg vorbis,mp3,flac,mp2,8svx,aiff,amr nb,amr wb) (ogg vorbis,mp3,flac,mp2,8svx,aiff,amr nb,amr wb) 34 35Filters: 36sox (sample rate, sample size, channels, normalize, bass, treble) 37 38ReplayGain calculators: 39aacgain (aac,mp3) 40metaflac (flac) 41mp3gain (mp3) 42vorbisgain (ogg vorbis) 43wvgain (wavpack) 44mpcgain (musepack) 45 46CD rippers: 47cdparanoia 48 49If you try to convert a file that is not supported, soundKonverter will tell you which backend you need to install. 50 51soundKonverter has nothing to do with the soundconverter project, the very similar name is just an unfortunate coincident. 52 53Websites: https://github.com/dfaust/soundkonverter 54 http://kde-apps.org/content/show.php?content=29024 55 56 57 58Feature list: 59============= 60- Convert audio files between many formats 61- Change sample rate and sample size during conversion 62- Apply effects like normalize during conversion 63- Convert the audio stream from video files to audio files 64- Convert multiple files at once 65- Calculate ReplayGain for many formats 66- ReplayGain tool for calculating and removing ReplayGain tags 67- Calculate ReplayGain for multiple files or file stets at once 68- Conversion and ReplayGain calculation is very scalable, the conversion of 100000 files or more is not a problem 69- Copy tags and covers when converting files (note: for ogg/METADATA_BLOCK_PICTURE, flac and asf/wma files, taglib 1.7 or higher is needed) 70- Rip multiple audio CDs at once 71- Retrieve audio CD information from CDDB and MusicBrainz 72- Easy to use, just choose a file format and a quality level 73- Detailed control, if you want to choose the conversion settings in more detail, simply switch to the "detailed" tab 74- Manage your preferred conversion options with profiles 75- Contextual help, e.g. if you don't know what the speex format is, just click on the "info" button next to it. 76 Or if you want to add a file that isn't supported, soundKonverter will tell you how to enable the format if possible. 77- Possibility to configure which backend shall be used for which codec - or let soundKonverter optimize that for you. 78 Every time you install or remove backends soundKonverter will suggest optimizations if possible. 79- Possibility to integrate soundKonverter in other applications or scripts by using its command line interface 80 81 82 83Installation: 84============= 85This section describes install soundKonverter from its sources. 86If you prefer to use precompiled packages have a look at the corresponding section below. 87 88First you should make sure that all dependencies are installed. 89soundKonverter will need the following packages to compile: 90kde development packages version 4.4 or higher 91taglib development package version 1.4 or higher 92cdparanoia development package 93libkcddb (KF5Cddb) development package 94gettext-tools 95cmake 96All dependencies - and whether they are fulfilled - should be shown when running cmake. 97 98Then open a console and change to the soundKonverter source directory and execute the following commands: 99 100mkdir build 101cd build 102cmake -DCMAKE_INSTALL_PREFIX=`kde4-config --prefix` .. 103make 104sudo make install 105 106In order to compile soundKonverter with debug information the commands will look like this: 107 108mkdir build 109cd build 110cmake -DCMAKE_INSTALL_PREFIX=`kde4-config --prefix` -DCMAKE_BUILD_TYPE=debugfull .. 111make 112sudo make install 113 114Note: `kde4-config --prefix` should return the installation path of kde. On some systems you might need to use kde-config. 115Or you can just define a path by yourself, "/usr" will be fine for most systems. 116 117For installing soundKonverter to your home directory see Building Amarok Locally at: http://amarok.kde.org/wiki/2.0_Development_HowTo 118 119 120 121Un-Installation: 122================ 123For uninstalling soundKonverter, open a console and change to the soundKonverter build directory. 124(If you followed the instructions above it's the directory named "build" in the soundKonverter source directory.) 125Then execute one of the following commands: 126 127sudo make uninstall 128or 129sudo xargs rm < install_manifest.txt 130 131In order to remove the soundKonverter configuration and kde integration, run the following commands: 132 133rm `kde4-config --localprefix`share/config/soundkonverterrc 134rm -r `kde4-config --localprefix`share/apps/soundkonverter 135rm `kde4-config --localprefix`share/kde4/services/ServiceMenus/add_replaygain_with_soundkonverter.desktop 136rm `kde4-config --localprefix`share/kde4/services/ServiceMenus/convert_with_soundkonverter.desktop 137 138this will - depending on the location of your local kde directory - result in something like: 139 140rm ~/.kde4/share/config/soundkonverterrc 141rm -r ~/.kde4/share/apps/soundkonverter 142rm ~/.kde4/share/kde4/services/ServiceMenus/add_replaygain_with_soundkonverter.desktop 143rm ~/.kde4/share/kde4/services/ServiceMenus/convert_with_soundkonverter.desktop 144 145 146 147Precompiled packages: 148===================== 149You can find soundKonverter packages for various distributions with a nice download interface and some instructions at: 150http://software.opensuse.org/download.html?project=home:HessiJames&package=soundkonverter 151 152For more information see: https://github.com/dfaust/soundkonverter/wiki/Installing%20soundKonverter#precompiled-packages 153 154 155 156Git repository: 157=============== 158For everybody who is interested, there is a git repository at https://github.com/dfaust/soundkonverter 159In order to obtain the source code from the git repository you need to install "git" and execute the following commands: 160 161initialize local git repository: 162 163git clone git://github.com/dfaust/soundkonverter.git 164 165update repository: 166 167git pull 168 169 170 171Reporting bugs - please report every bug you find, that's the only way I can fix it: 172==================================================================================== 173You can either leave a comment at http://kde-apps.org/content/show.php?content=29024 174or write me a mail to hessijames@gmail.com 175but the best way is to create an issue at https://github.com/dfaust/soundkonverter/issues 176 177Some tips for creating a useful bug report: 178 179Include the version number of soundKonverter you are using: 180Click "Help" in the menu bar and select "About soundKonverter...", a new window will open and the version number will be shown at the top. 181 182If you have problems converting a file, please follow these steps: 1831. Try to convert the file. 1842. Then open the "Log Viewer" by clicking on "Conversion" in the menu bar and selecting "View logs...". 185The Log Viewer will now open in a new window. 1863. By default the Log Viewer will show the log of the soundKonverter application, sending me this log won't hurt. 1874. But the more important log is the log for the file you just tried to convert in step 1. To see that log, click on the combo box (drop down box) at the top of the Log Viewer window and select the file. 1885. To save a log to a file, click on the "Save to file..." button on the bottom of the Log Viewer. 1896. Attach latter or both log files to your bug report. 190 191In case soundKonverter crashes and you can't save the conversion log file, you can make soundKonverter write log files directly to the hard drive. (disabled by default for performance reasons.) 192You can find this option in the advanced tab of the configuration dialog. 193 194In case of a crash: 195After soundKonverter has crashed a new window should appear. It's KDE's crash handler and it has two tabs. 196Click on the tab "Developer information" and wait a few seconds until the crash has been analyzed. 197You will see three stars at the top right corner indicating how useful the crash report is. 198If all three stars are filled your crash report is very useful otherwise it might not help. 199If you don't have three filled stars you can install some additional developer information. 200a) If you are running openSUSE you can install soundKonverter via the open build service. 201 It is available at the KDE:Extra and the home:HessiJames repositories. In addition to the soundkonverter package these repositories also contain 202 a soundkonverter-debuginfo package which you have to install. It contains additional developer information. 203 After installing the soundkonverter-debuginfo package you can go back to the crash handler window and click on the "reload" button. 204 All these steps should actually happen automatically after hitting the "install missting debug symbols" button. 205b) If you have installed soundKonverter from its sources you will have to compile it with debug information enabled. Have a look at the "Installation" section above. 206 After you installed soundKonverter with debug information enabled you will have to close the crash handler window and try to reproduce the crash. 207c) If you are running an operating system other than openSUSE and have installed soundKonverter via a software repository chances are you can simply click on the "install missing debug symbols" button 208 and the additional developer information get installed automatically. But I haven't tested it. 209In order to reproduce a crash try doing the exact same thing you did when the crash occurred. 210If you managed to get a useful crash report you can either directly send it to me by clicking on the "Report problems or wishes" button 211or even better you can copy the generated information and create a new issue at https://github.com/dfaust/soundkonverter/issues and paste them there. 212 213 214 215Participating: 216============== 217Translations: 218If you would like to translate soundKonverter to your native language you can request a new translation at https://www.transifex.net/projects/p/soundkonverter 219 220Patches: 221You can very easily fork the current code with github. You can then work in your forked version and request a pull. 222Have a look at: https://github.com/dfaust/soundkonverter 223