mirror of
https://github.com/Yetangitu/ampache
synced 2025-10-05 19:41:55 +02:00
157 lines
5.8 KiB
Markdown
Executable file
157 lines
5.8 KiB
Markdown
Executable file
Ampache
|
|
=======
|
|
[www.ampache.org](http://www.ampache.org) |
|
|
[ampache.github.io](http://ampache.github.io)
|
|
|
|
Basics
|
|
------
|
|
|
|
Ampache is a web based audio/video streaming application and file
|
|
manager allowing you to access your music & videos from anywhere,
|
|
using almost any internet enabled device.
|
|
|
|
Ampache's usefulness is heavily dependent on being able to extract
|
|
correct metadata from embedded tags in your files and/or the filename.
|
|
Ampache is not a media organiser; it is meant to be a tool which
|
|
presents an already organised collection in a useful way. It assumes
|
|
that you know best how to manage your files and are capable of
|
|
choosing a suitable method for doing so.
|
|
|
|
Recommended Version
|
|
-------------------
|
|
|
|
Currently, the recommended version is [git HEAD](https://github.com/ampache/ampache/archive/master.tar.gz).
|
|
[](https://travis-ci.org/ampache/ampache)
|
|
[](https://scrutinizer-ci.com/g/ampache/ampache/?branch=master)
|
|
|
|
Latest changes but unstable is [develop branch](https://github.com/ampache/ampache/archive/develop.tar.gz).
|
|
[](https://travis-ci.org/ampache/ampache)
|
|
[](https://scrutinizer-ci.com/g/ampache/ampache/?branch=develop)
|
|
|
|
Requirements
|
|
------------
|
|
|
|
* A web server. All of the following have been used, though Apache
|
|
receives the most testing:
|
|
* Apache
|
|
* lighttpd
|
|
* nginx
|
|
* IIS
|
|
|
|
* PHP 5.3 or greater.
|
|
|
|
* PHP modules:
|
|
* PDO
|
|
* PDO_MYSQL
|
|
* hash
|
|
* session
|
|
* json
|
|
* simplexml (This is not strictly necessary, but may result in a better experience.)
|
|
* curl (This is not strictly necessary, but may result in a better experience.)
|
|
|
|
* MySQL 5.x
|
|
|
|
Installation
|
|
------------
|
|
|
|
Please see [the wiki](https://github.com/ampache/ampache/wiki/Installation)
|
|
|
|
Upgrading
|
|
---------
|
|
|
|
If you are upgrading from an older version of Ampache we recommend
|
|
moving the old directory out of the way, extracting the new copy in
|
|
its place and then copying the old config/ampache.cfg.php, /rest/.htaccess,
|
|
and /play/.htaccess files if any. All database updates will be handled by Ampache.
|
|
|
|
License
|
|
-------
|
|
|
|
Ampache is free software; you can redistribute it and/or
|
|
modify it under the terms of the GNU General Public License v2
|
|
as published by the Free Software Foundation.
|
|
|
|
Ampache includes some external modules that carry their own licensing.
|
|
|
|
* [getID3](http://getid3.sourceforge.net): GPL v2
|
|
* [Horde_Browser](http://www.horde.org): LGPL v2.1
|
|
* [PHP-gettext](https://launchpad.net/php-gettext): GPL v2
|
|
* [MusicBrainz](https://github.com/mikealmond/MusicBrainz): MIT
|
|
* PHP MPD interface: GPL v2
|
|
* [PHPMailer](https://github.com/PHPMailer/PHPMailer): LGPL v2.1
|
|
* [jQuery](http://jquery.org): MIT
|
|
* [Requests](http://requests.ryanmccue.info): ISC Licensed
|
|
* [Whatever:hover](http://www.xs4all.nl/~peterned): LGPL v2.1
|
|
* [xbmc-php-rpc](https://github.com/karlrixon/xbmc-php-rpc): GPL v3
|
|
* [Dropbox SDK](https://github.com/dropbox/dropbox-sdk-php): MIT
|
|
* [jPlayer](http://jplayer.org): MIT
|
|
* [prettyPhoto](http://www.no-margin-for-errors.com/projects/prettyphoto-jquery-lightbox-clone): GPL v2
|
|
* [Tag-it!] (http://aehlke.github.io/tag-it): MIT
|
|
* [PHP Echo Nest API] (https://github.com/bshaffer/php-echonest-api): MIT
|
|
* [Noty] (http://ned.im/noty): MIT
|
|
* [jScroll] (https://github.com/pklauzinski/jscroll): MIT
|
|
* [jquery.qrcode] (http://jeromeetienne.github.io/jquery-qrcode): MIT
|
|
* [PHP OpenID] (https://github.com/openid/php-openid): Apache License
|
|
* [Ratchet] (http://socketo.me): MIT
|
|
* [ReactPHP] (https://github.com/reactphp/react): MIT
|
|
* [Guzzle] (https://github.com/guzzle/guzzle): MIT
|
|
* [Symfony Components] (https://github.com/symfony): MIT
|
|
* [Evenement] (https://github.com/igorw/evenement): MIT
|
|
* [RhinoSlider] (http://rhinoslider.com): MIT
|
|
* [MediaTable] (https://github.com/edenspiekermann/MediaTable): MIT
|
|
* [Responsive Elements] (https://github.com/kumailht/responsive-elements): MIT
|
|
* [Bootstrap] (http://getbootstrap.com): MIT
|
|
* [jQuery Knob] (https://github.com/aterrien/jQuery-Knob): MIT
|
|
* [jQuery File Upload] (https://github.com/blueimp/jQuery-File-Upload): MIT
|
|
* [jsTree] (http://www.jstree.com): MIT
|
|
* [php-tmdb-api] (https://github.com/wtfzdotnet/php-tmdb-api) : MIT
|
|
* [TvDb] (https://github.com/Moinax/TvDb) : MIT
|
|
* [jQuery DateTimePicker] (https://github.com/xdan/datetimepicker) : MIT
|
|
* [pChart] (http://www.pchart.net) : GPL v3
|
|
* [ZipStream-PHP] (https://github.com/maennchen/ZipStream-PHP) : [ZipStream-PHP license] (modules/zipstream/COPYING)
|
|
|
|
|
|
Translations
|
|
------------
|
|
|
|
Ampache is currently translated (at least partially) into the
|
|
following languages. If you are interested in updating an existing
|
|
translation or adding a new one please see /locale/base/TRANSLATIONS
|
|
for more instructions.
|
|
|
|
* English (en_US)
|
|
* Arabic (ar_SA)
|
|
* Catalan (ca_ES)
|
|
* Catalan (ca_ES)
|
|
* Czech (cs_CZ)
|
|
* Dutch (nl_NL)
|
|
* French (fr_FR)
|
|
* German (de_DE)
|
|
* Greek (el_GR)
|
|
* Italian (it_IT)
|
|
* Japanese (ja_JP)
|
|
* Norwegian (nb_NO)
|
|
* Persian (fa_IR)
|
|
* Polish (pl_PL)
|
|
* Russian (ru_RU)
|
|
* Spanish (es_ES)
|
|
* Swedish (sv_SE)
|
|
* UK English (en_GB)
|
|
|
|
Credits
|
|
-------
|
|
|
|
Thanks to all those who have helped make Ampache awesome: [Credits](docs/ACKNOWLEDGEMENTS)
|
|
|
|
|
|
Contact Us
|
|
----------
|
|
|
|
Hate it? Love it? Let us know. Also let us know if you think of any
|
|
more features, encounter bugs, etc.
|
|
|
|
* [Public Repository](http://github.com/ampache)
|
|
* IRC: chat.freenode.net #ampache
|
|
* [Issue Tracker](https://github.com/ampache/ampache/issues)
|
|
* [Documentation](https://github.com/ampache/ampache/wiki)
|
|
|