diff options
author | gregory guy <gregory-tde@laposte.net> | 2020-01-29 01:10:31 +0100 |
---|---|---|
committer | Slávek Banko <slavek.banko@axis.cz> | 2020-03-04 23:49:15 +0100 |
commit | 16ec57d25f13f92bd0d84317f1679fef3b98eeaa (patch) | |
tree | 49e41122369e3ef7e0bce7c20cd92eaf1ece3b17 /README | |
parent | af56fd3c134a4304763d656f99b694f85acf8238 (diff) | |
download | amarok-16ec57d25f13f92bd0d84317f1679fef3b98eeaa.tar.gz amarok-16ec57d25f13f92bd0d84317f1679fef3b98eeaa.zip |
Conversion to the cmake building system based on S.Amelian's work.
The embedded sqlite3 has been upgraded to 3.4.2 .
Added few man pages taken from the Debian packaging system.
Rework of the README and INSTALL files.
Signed-off-by: gregory guy <gregory-tde@laposte.net>
Signed-off-by: Slávek Banko <slavek.banko@axis.cz>
Diffstat (limited to 'README')
-rw-r--r-- | README | 202 |
1 files changed, 13 insertions, 189 deletions
@@ -1,20 +1,19 @@ - Amarok - the audio player for KDE + Amarok - an audio player for TDE =================================== -There are many media players around these days, true. What's missing from most -players is a user interface that doesn't get in the way of the user. How many -buttons do you have to press for simply adding some new tracks to the playlist? -Amarok tries to be a little different, providing a simple drag and drop -interface that really makes playlist handling easy. +There are many media players around these days, that is true. +What's missing from most players is a user interface that doesn't get in +the way of the user. Amarok tries to be a little different, providing a +simple drag and drop interface that really makes playlist handling easy. FEATURES ========== * Quick and simple drag and drop playlist creation - * Music library (built-in SQLite, MySQL, or PostgreSQL) - * Multiple backends supported (xine, Helix, and NMM) + * Multiple database backends (SQLite, MySQL or PostgreSQL) + * Xine engine backend to play the music library * Plays all audio formats known to man * 10 band equalizer * Automatic cover art download using Amazon services @@ -31,193 +30,18 @@ interface that really makes playlist handling easy. * Access to iPod, iRiver IFP, USB Mass Storage and many other devices * Powerful scripting interface * Complete DCOP Access - * KDE integration + * TDE integration * Preview and buy albums from the Magnatune.com music store --------------------------------------------------------------------------------- - DEPENDENCIES -============== - -Required - * KDE-Libs 3.3 (or newer) - http://www.kde.org - - * TagLib 1.4 (or newer) - (metadata tagging library) - http://freshmeat.net/projects/taglib - - * Ruby 1.8 - (programming language, used for scoring, lyrics, last.fm streams) - http://www.ruby-lang.org - - * One of the multimedia frameworks listed below: - -Recommended - * xine-lib 1.0.2 (or newer) - Note: xine-lib 1.1.1 is required for gapless playback. - (multimedia framework) - http://xinehq.de/ - -Optional - * RealPlayer 10 or HelixPlayer 1.0 - (multimedia framework) - http://www.real.com - (Note: only HelixPlayer is exactly RealPlayer without MP3 support) - - * KDE-Base 3.3 (or newer) - (needed for Konqueror Sidebar) - http://www.kde.org - - * MySQL 4 or 5 - (faster database support) - http://www.mysql.com - - * PostgreSQL 7.4 - (faster database support) - http://www.postgresql.org - - * OpenGL accelerated X-Server - (visualization rendering) - - * Libvisual 0.4.0 + SDL 1.2 - (visualization framework) - http://localhost.nl/~synap/libvisual/ - http://www.libsdl.org - - * ProjectM 0.96 (or newer) - (visualization plugins for Libvisual or XMMS) - http://xmms-projectm.sourceforge.net/ - - * libtunepimp 0.3 (or newer) - (automatic tagging support) - http://www.musicbrainz.org/ - - * K3B 0.11 (or newer) - (CD burning support) - http://www.k3b.org - - * libgpod 0.4.2 (or newer) - (iPod support) - Note: libgpod 0.6.0 is required for the newest Apple iPods. - http://www.gtkpod.org/libgpod.html - - * libifp 1.0.0.2 - (iRiver iFP support) - http://ifp-driver.sourceforge.net/libifp/ - - * libmp4v2 (mpeg4ip 1.5 is recommended, faad2 is less reliable) - (MP4/AAC tag reading & writing) - http://www.sf.net/projects/mpeg4ip - http://www.audiocoding.com - - * libnjb 2.2.4 (older versions may work) - (NJB mediadevice (Creative Nomad/Zen family, Dell DJ devices) - http://www.sf.net/projects/libnjb - - * libmtp 0.1.1 (or newer) - (MTP media device support AKA PlaysForSure) - http://libmtp.sourceforge.net/ - - * libkarma 0.0.5 && OMFS 0.6.1 - (Rio Karma support via USB) - http://freakysoft.de/html/libkarma/ && http://linux-karma.sf.net/ - -Please note, if compiling from source you must also install the devel versions -of these packages. --------------------------------------------------------------------------------- - - - IMPORTANT INSTALL INSTRUCTIONS -================================ - -In order to compile and install Amarok on your system, type the following in the -base directory of the Amarok distribution: - - - % ./configure --prefix=`tde-config --prefix` - % make - % make install - - -Note: --enable-final is not guaranteed to work - - -Packages for popular distributions are available at http://amarok.kde.org --------------------------------------------------------------------------------- - - - INSTALLATION-FAQ -================== - -Q: Can I improve Amarok's startup time? -A: Prelinking Amarok has spectacular results; however if you have binary openGL - drivers (eg Nvidia drivers), you will need to compile Amarok --without-opengl - in order to get the amarokapp binary to prelink (the amarok binary is not - important here). --------------------------------------------------------------------------------- - - - OTHER-FAQS -============ - -For answers to problems like "Amarok won't play any MP3s!" and "My MP3s skip -and stutter!" please visit: - - http://amarok.kde.org/ --------------------------------------------------------------------------------- - - - INFORMATION FOR PACKAGERS -=========================== - -For Amarok packages we suggest you build: - - % ./configure --disable-debug - -It is possible to build Amarok to use MySQL as the database backend. Using -MySQL makes the Amarok collection faster. - -We suggest compiling Os, there is no particular part of Amarok that would -benefit from optimisation, so the smallest binary is probably the best route. - -In order to limit the dependencies the Amarok package demands we suggest -splitting Amarok into the following packages: - - 1. Amarok + one backend - 2. xine-engine - 3. Helix-engine - 4. amarok_libvisual - 5. ipod media device - 6. ifp media device - 7. njb media device - 8. mtp media device - 9. rio karma media device - -Amarok is modular and will be fully functional as long as one of 2 or 3 is -also installed. Hence we suggest Amarok + one backend. Feel free to include the -helix, MAS and NMM engines if you can satisfy their dependencies. - -Amarok ships with two binaries: amarok and amarokapp. The amarok binary is a -wrapper designed to speed up command line argument passing. amarokapp is the -real Amarok. - -If you make packages for Amarok please let us know and we'll link to you on the -homepage (as long as you don't object). --------------------------------------------------------------------------------- - CONTRIBUTING ============== -If you wish to contribute to Amarok, you should build it from SVN and subscribe -to the amarok-devel mailing list. The IRC channel is also a place where -it's nice to be, since you can talk to other developers much easier, and -get instant notification of commits to the SVN. For instant email notification -of commits, visit http://commitfilter.kde.org/. --------------------------------------------------------------------------------- +If you wish to contribute to Amarok (TDE), you might do so: +- TDE Gitea Workspace (TGW) collaboration tool. + https://mirror.git.trinitydesktop.org/gitea -WWW : http://amarok.kde.org -MAIL: amarok@kde.org -IRC : irc.freenode.net - #amarok, #amarok.de, #amarok.es +- TDE Weblate Translation Workspace (TWTW) collaboration tool. + https://mirror.git.trinitydesktop.org/weblate |