This repository has been archived by the owner on Sep 24, 2023. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathREADME
178 lines (134 loc) · 6.09 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
Amarok - the audio player for KDE
===================================
There are many media players around these days, it's 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.
FEATURES
==========
* Quick and simple drag and drop playlist creation
* Music library
* Cross platform: Support for Unix, MacOS X and Windows
* Plays all audio formats known to man
* Cover art download using Last.fm services
* Automatic play-statistics generation (iRate style)
* Full lyrics download
* Learn about your music with integrated Wikipedia
* Full Last.fm support
* gpodder.net support
* Configurable on screen display for track changes
* Podcast support
* iPod support, as well as other media players
* Powerful scripting interface
* KDE integration
* Integration with multiple web sources including Magnatune, Jamendo,
Ampache, MP3tunes, and others.
--------------------------------------------------------------------------------
DEPENDENCIES
==============
Required
* KDE-Libs 4.8.4 (or newer) + KDE-Base-runtime 4.8 (oxygen-icons) (or newer)
http://www.kde.org
* Phonon backend, one of the following is strongly recommended
* phonon-gstreamer 4.6.3 (or newer)
* phonon-vlc 0.6.1 (or newer; as of 0.6.1 doesn't yet play Audio CDs, bug 313046)
* Qt 4.8.3 (or newer)
http://qt-project.org
* TagLib 1.7 (or newer)
(Metadata tagging library)
* TagLib Extras 1.0.1 (or newer)
(Support for metadata reading of additional file types)
svn://anonsvn.kde.org/home/kde/trunk/kdesupport/taglib-extras
* MySQL 5.0 (or newer) Embedded: libmysqld compiled with fPIC
(In-process database support)
* QtScript Generator, Qt Bindings 0.1.0
(Qt Bindings for QtScript for Amarok's scripting system)
http://code.google.com/p/qtscriptgenerator/
http://qt.gitorious.org/qt-labs/qtscriptgenerator
* LibQCA 2.0.2 (or newer)
(Qt Cryptographic Architecture)
http://delta.affinix.com/qca/
Optional
* Taglib 1.8 for support of MOD, IT, S3M and XM files
* Taglib 1.9 for support of Opus files
http://developer.kde.org/~wheeler/taglib.html
https://github.com/taglib/taglib
* iPod support requires:
* libgpod 0.8.2 (or newer)
http://www.gtkpod.org/libgpod/
* optional iPod album artwork support requires:
* libgpod built with GDKPixBuf support enabled
* GDKPixBuf 2.0 (or newer) itself
* libmtp 1.0.0 (or newer)
(MTP device support)
http://libmtp.sourceforge.net/
* Spectrum analyzer requires:
* QtOpenGL
* Mp3tunes.com integration (including syncronization) requires:
* OpenSSL http://www.openssl.org
* libxml2 http://xmlsoft.org
* libcurl http://curl.haxx.se
* Glib2 http://www.gtk.org
* Loudmouth, the Jabber library, http://www.loudmouth-project.org/
* Qt must be compiled with Glib enabled
* Liblastfm 1.0.3 (or newer)
(For scrobbling, internet radio, and artist info)
http://cdn.last.fm/client/liblastfm-1.0.3.tar.gz
https://github.com/eartle/liblastfm
* QJson 0.7 (or newer)
(Qt JSON Parser for the Playdar Collection)
http://qjson.sourceforge.net/
* MySQL 5.0 (or newer) Server (external database support)
* MusicBrainz-based audio fingerprint tag lookup requires:
* FFmpeg 0.7.0 (or newer) - http://ffmpeg.org/
* libavcodec & libavformat specifically
* LibOFA - http://code.google.com/p/musicip-libofa/
* gpodder.net Podcast Provider & Service
* libmygpo-qt 1.0.7 (or newer)
* Transcoding requires (at runtime):
* FFmpeg 0.7.0 (or newer) - http://ffmpeg.org/
* For all supported encoders to be available in Amarok, FFmpeg needs to
support the following codecs:
* libfaac (NOT just "aac")
* alac
* flac
* libmp3lame (NOT just "mp3")
* libvorbis (NOT just "vorbis")
* wmav2
* CD support requires:
* audiocd-kio - http://www.kde.org/ (part of KDE multimedia)
* Downloading songs from Amazon works best on non Windows systems using
* clamz - https://code.google.com/p/clamz/
* The official downloader should work fine on Windows, too. But it's broken on many Linux systems.
* Building tests require:
* gmock 1.4 (or newer) - http://code.google.com/p/googlemock/
Please note that if compiling from source you also need to install -dev/-devel
versions of these packages, depending on your distribution.
--------------------------------------------------------------------------------
IMPORTANT INSTALL INSTRUCTIONS
================================
To compile from source, please refer to the INSTALL file.
Packages for popular distributions are available at http://amarok.kde.org
--------------------------------------------------------------------------------
FURTHER RESOURCES
===================
For answers to problems like "Amarok won't play any MP3s!" and "My MP3s skip
and stutter!" please visit:
http://amarok.kde.org/
--------------------------------------------------------------------------------
CONTRIBUTING
==============
If you wish to contribute to Amarok, you should build it from Git and subscribe
to the amarok AT kde.org mailing list. The IRC channel is also a place where
it's nice to be. There you can talk to other developers easily, and you can see
instant notifications of commits to the Git master repository. For instant email
notification of commits, visit http://commitfilter.kde.org/ , and http://amarok.be/fisheye
provides a slightly-less-instant overview.
More information at:
http://community.kde.org/Amarok/Development/Join
See you on IRC!
--------------------------------------------------------------------------------
WWW: http://amarok.kde.org
MAIL: [email protected]
IRC: irc.freenode.net - #amarok, #amarok.de, #amarok.es, #amarok.fr