diff options
author | Paul Arthur <paul.arthur@flowerysong.com> | 2013-03-27 14:30:49 -0400 |
---|---|---|
committer | Paul Arthur <paul.arthur@flowerysong.com> | 2013-03-27 14:30:49 -0400 |
commit | 0ecaf693698b1ead5dc9167f7166770a54e39f51 (patch) | |
tree | 0d611fc9c8a520267c214db94183efd0a06fcb67 | |
parent | b3e78cc4b74fa7984f673326acc129c98a95abd0 (diff) | |
download | ampache-0ecaf693698b1ead5dc9167f7166770a54e39f51.tar.gz ampache-0ecaf693698b1ead5dc9167f7166770a54e39f51.tar.bz2 ampache-0ecaf693698b1ead5dc9167f7166770a54e39f51.zip |
First pass at making a github README
-rwxr-xr-x | README.md | 125 | ||||
-rwxr-xr-x | docs/README | 159 |
2 files changed, 125 insertions, 159 deletions
diff --git a/README.md b/README.md new file mode 100755 index 00000000..6d40e20d --- /dev/null +++ b/README.md @@ -0,0 +1,125 @@ +Ampache +======= + +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. + +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) +* German (de_DE) +* Spanish (es_ES) +* Dutch (nl_NL) +* Norwegian (nb_NO) +* UK English (en_GB) +* Italian (it_IT) +* French (fr_FR) +* Swedish (sv_SE) +* Japanese (ja_JP) +* Catalan (ca_ES) +* Russian (ru_RU) +* Czech (cs_CZ) + +Credits +------- + +Thanks to all those who have helped make Ampache awesome: + +* Scott Kveton: Original creator of Ampache, 2001 - 2003 +* Robert Hopson +* Andy Morgan +* RosenSama +* latka +* Lamar Hansford +* Lacy Morrow +* Karl Vollmer (vollmerk) +* Paul Arthur MacIain (flowerysong) +* Chris Slamar (cslamar) +* Holger Brunn +* Kevin Purdy (purdyk) +* Charlie Smotherman (porthose) + +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. + +Required PHP modules: + +* PDO +* PDO_MYSQL +* hash +* session +* json + +MySQL 5.x + +Installation +------------ + +Please see docs/INSTALL + +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 file into config/. 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 +* php_musicbrainz: LGPL v2.1 +* PHP MPD interface: GPL v2 +* [PHPMailer](http://phpmailer.codeworxtech.com/): LGPL v2.1 +* [Prototype](http://www.prototypejs.org/): MIT +* [Snoopy](http://snoopy.sourceforge.net/): LGPL v2.1 +* validateEmail.php: "free for any use" +* [Whatever:hover](http://www.xs4all.nl/~peterned): LGPL v2.1 + +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) + diff --git a/docs/README b/docs/README deleted file mode 100755 index b9c7f47e..00000000 --- a/docs/README +++ /dev/null @@ -1,159 +0,0 @@ -------------------------------------------------------------------------------- ---------- README - Ampache v.3.6 ----------- -------------------------------------------------------------------------------- - -Contents: - - 1. Intro - a) Supported File-Types - b) Supported Stream Methods - c) Current Translations - d) Special Thanks - 2. Getting all the components - 3. Setting Up - a) Upgrading - 4. License - 5. Contact info - -1. Intro: - - Ampache is a PHP-based interface to a MySQL database - where information about your audio files are stored. The songs - are streamed using PHP; older versions required mod_mp3 but this - version no longer does. The songs are cataloged via PHP - scripts. - - These tools are heavily dependent on quality tags in your audio - files and or the file system organization. If you've kept them - up-to-date or organized this is the tool for you. - - See CHANGELOG for version information. - - A) Supported File-Types - - Ampache currently supports the following audio file types. If - you would like Ampache to support an additional file type please - contact us on irc, or the forums and we will investigate adding - them. Thanks - - - MP3 (id3v1 && id3v2) - - OGG - - WMA/ASF - - FLAC - - RM - - AAC/M4A/MP4 - - MPC - - WV - - SHN - - APE - - SPX - - FLV - - AVI - - MPG - - M4V - - WMV - - B) Supported Stream Methods - - Ampache currently supports the following different methods for - streaming your audio files. Please contact us if you would like - to see additional methods. - - - Single Stream - - extended m3u - - simple m3u - - standard pls - - ASX - - RAM - - XSPF - - Realtime Downsampling - - Integrated Flash Player - - Automatic Downsampling based on load - - Local/Remote network definition based downsampling - - On the Fly Transcoding (Requires additional applications) - - Localplay - - Music Player Daemon (MPD) - - Winamp using (HTTPQ) - - Shoutcast - - Icecast2 - - Democratic Vote based playback - - 3rd Party clients using API (Amarok,Coherence,Quickplay) - - 3rd Party Mobile clients using API (Android,Iphone,Blackberry,PalmOS) - - C) Current Translations - - Ampache is currently translated into the following languages. If - you are interested in updating an existing translation or adding - a new one please contact us at translation@ampache.org or see - /locale/base/TRANSLATIONS for more instructions. - - - English (en_US) - - German (de_DE) - - Spanish (es_ES) - - Dutch (nl_NL) - - Norwegian (nb_NO) - - UK English (en_GB) - - Italian (it_IT) - - French (fr_FR) - - Swedish (sv_SE) - - Japanese (ja_JP) - - Catalan (ca_ES) - - Russian (ru_RU) - - Czech (cs_CZ) - - D) A Special Thanks: - Thanks to those who've helped us make Ampache so useable: - Scott Kveton - Original create of Ampache 2001 - 2003 - Robert Hopson - Libglue, Playlists, Ogg support.. and much more - Andy Morgan - Sage / Voice of Reason - RosenSama - Previous Developer - latka (from media.tangent.org site) for orphaned song ideas - Lamar Hansford (README/INSTALL improvements) & Upload - Lacy Morrow (Flash Player) - -2. Getting all the components - - Apache >= 1.3.x http://www.apache.org OR other web server - PHP >= 5.3.x http://www.php.net ** - PHP5-Mysql - PHP5-Session - PHP5-gd (recommended) - PHP5 ICONV - PHP5 ZLIB support (recommended) - MySQL >= 5.x+ http://www.mysql.com - -3. Setting Up - - Please see the included INSTALL file or if possible the wiki - for the most update to date instructions, http://ampache.org/wiki - -3a. Upgrading Your Ampache Install - - 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 file. All database updates - will be handled by the /update.php script. There is no need to insert - the /sql/ampache.sql if you have an existing installation. - - Please see MIGRATION for specific instructions based on the version - -4. License - - This Application falls under the Standard GPL v2. See Licence - included with this tar file. Credit for code is listed in the - changelog. - -5. Contact Info - - Hate it? Love it? Let us know. Let us know if you think of any - more features, bugs, etc. - - Public Source Repository: http://gitorious.org/ampache - IRC: irc.ampache.org #ampache (Freenode) - Forums: http://ampache.org/forums - Bugs: http://ampache.org/bugs - Wiki: http://ampache.org/wiki - Demo: http://ampache.org/demo - - -Karl Vollmer - vollmer@ampache.org |