Warning, /multimedia/amarok/README is written in an unsupported language. File is not indexed.

0001 Amarok - the audio player for KDE
0002 ===================================
0003 
0004 There are many media players around these days, it's true. What's missing from most
0005 players is a user interface that doesn't get in the way of the user. How many
0006 buttons do you have to press for simply adding some new tracks to the playlist?
0007 Amarok tries to be a little different, providing a simple drag and drop interface
0008 that really makes playlist handling easy.
0009 
0010 
0011  FEATURES
0012 ==========
0013 
0014     * Quick and simple drag and drop playlist creation
0015     * Music library
0016     * Cross platform: Support for Unix, MacOS X and Windows
0017     * Plays all audio formats known to man
0018     * Cover art download using Last.fm services
0019     * Automatic play-statistics generation (iRate style)
0020     * Full lyrics download
0021     * Learn about your music with integrated Wikipedia
0022     * Full Last.fm support
0023     * gpodder.net support
0024     * Configurable on screen display for track changes
0025     * Podcast support
0026     * iPod support, as well as other media players
0027     * Powerful scripting interface
0028     * Integration with Plasma and KDE Applications
0029     * Integration with multiple web sources including Magnatune, Jamendo,
0030       Ampache, MP3tunes, and others.
0031 --------------------------------------------------------------------------------
0032 
0033 
0034  DEPENDENCIES
0035 ==============
0036 
0037 The following list should give you an impression what's required but it might
0038 not be entirely up to date. You can always look at CMakeLists.txt to discover
0039 the most recent dependencies.
0040 
0041 Required
0042     * KDE Frameworks 5.41 (or newer, for an exact list look at CMakeLists.txt)
0043       https://www.kde.org
0044 
0045     * Phonon 4.6.60 (or newer with support for Qt5) and one of the following backends:
0046       * phonon-gstreamer 4.6.3 (or newer)
0047       * phonon-vlc 0.6.1 (or newer; as of 0.6.1 doesn't yet play Audio CDs, bug 313046)
0048 
0049     * Qt 5.10 (or newer)
0050       https://qt.io/
0051 
0052     * TagLib 1.7 (or newer)
0053       (Metadata tagging library)
0054 
0055     * TagLib Extras 1.0.1 (or newer)
0056       (Support for metadata reading of additional file types)
0057       svn://anonsvn.kde.org/home/kde/trunk/kdesupport/taglib-extras
0058 
0059     * MySQL 5.0 (or newer) / MariaDB (external database support) or MariaDB
0060       Embedded (In-process database support)
0061 
0062 Optional
0063     * Taglib 1.8 for support of MOD, IT, S3M and XM files
0064     * Taglib 1.9 for support of Opus files
0065       http://taglib.org/
0066       https://github.com/taglib/taglib
0067 
0068     * iPod support requires:
0069       * libgpod 0.8.2 (or newer)
0070         http://www.gtkpod.org/libgpod/
0071       * optional iPod album artwork support requires:
0072         * libgpod built with GDKPixBuf support enabled
0073         * GDKPixBuf 2.0 (or newer) itself
0074 
0075     * libmtp 1.0.0 (or newer)
0076       (MTP device support)
0077       http://libmtp.sourceforge.net/
0078 
0079     * Mp3tunes.com integration (including syncronization) requires:
0080       * OpenSSL https://www.openssl.org
0081       * libxml2 http://xmlsoft.org
0082       * libcurl https://curl.haxx.se
0083       * Glib2 https://www.gtk.org
0084       * Loudmouth, the Jabber library, http://www.loudmouth-project.org/
0085       * Qt must be compiled with Glib enabled
0086 
0087     * Liblastfm 1.0.3 (or newer)
0088       (For scrobbling, internet radio, and artist info)
0089       http://cdn.last.fm/client/liblastfm-1.0.3.tar.gz
0090       https://github.com/eartle/liblastfm
0091 
0092     * MusicBrainz-based audio fingerprint tag lookup requires:
0093       * FFmpeg 0.7.0 (or newer) - https://ffmpeg.org/
0094         * libavcodec & libavformat specifically
0095       * LibOFA - http://code.google.com/p/musicip-libofa/
0096 
0097     * gpodder.net Podcast Provider & Service
0098       * libmygpo-qt 1.1.0 (or newer)
0099 
0100     * Transcoding requires (at runtime):
0101       * FFmpeg 0.7.0 (or newer) - https://ffmpeg.org/
0102       * For all supported encoders to be available in Amarok, FFmpeg needs to
0103         support the following codecs:
0104         * aac (introduced in 3.0, https://www.ffmpeg.org/index.html#aac_encoder_stable)
0105         * alac
0106         * flac
0107         * opus
0108         * libmp3lame (NOT just "mp3")
0109         * libvorbis (NOT just "vorbis")
0110         * wmav2
0111 
0112     * CD support requires:
0113       * audiocd-kio - https://www.kde.org/ (part of KDE multimedia)
0114 
0115     * Building tests require:
0116       * gmock 1.4 (or newer) - https://github.com/google/googletest
0117 
0118 Please note that if compiling from source you also need to install -dev/-devel
0119 versions of these packages, depending on your distribution.
0120 --------------------------------------------------------------------------------
0121 
0122 
0123  IMPORTANT INSTALL INSTRUCTIONS
0124 ================================
0125 
0126 To compile from source, please refer to the INSTALL file.
0127 
0128 Packages for popular distributions are available at https://amarok.kde.org
0129 --------------------------------------------------------------------------------
0130 
0131 
0132  FURTHER RESOURCES
0133 ===================
0134 
0135 For answers to problems like "Amarok won't play any MP3s!" and "My MP3s skip
0136 and stutter!" please visit:
0137 
0138    https://amarok.kde.org/
0139 --------------------------------------------------------------------------------
0140 
0141 
0142  CONTRIBUTING
0143 ==============
0144 
0145 If you wish to contribute to Amarok, you should build it from Git and subscribe
0146 to the amarok AT kde.org mailing list. The IRC channel is also a place where
0147 it's nice to be. There you can talk to other developers easily, and you can see
0148 instant notifications of commits to the Git master repository. For instant email
0149 notification of commits, visit http://commitfilter.kde.org/ , and http://amarok.be/fisheye
0150 provides a slightly-less-instant overview.
0151 
0152 More information at:
0153 https://community.kde.org/Amarok/Development/Join
0154 
0155 See you on IRC!
0156 
0157 --------------------------------------------------------------------------------
0158 
0159 WWW:  https://amarok.kde.org
0160 MAIL: amarok@kde.org
0161 IRC:  irc.libera.chat - #amarok, #amarok-de, #amarok-es, #amarok-fr