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.
PHP JavaScript CSS Shell Batchfile Hack
Clone or download
wagnered Merge pull request #1760 from Psy-Virus/develop
Latest translation updates and maybe fix for #1738
Latest commit 33e3923 Aug 13, 2018
Permalink
Failed to load latest commit information.
.github Update ISSUE_TEMPLATE.md Jul 30, 2016
.tx Transifex config update Mar 7, 2016
admin updated php-cs-fixer to 2.3.2, .php_cs and scripts/test/* to match ve… Jun 24, 2017
bin Updated copyright year. Jun 22, 2017
channel Merge pull request #1526 from ibmibmibm/develop Jun 24, 2017
config Added .ogv encoding target for more efficient streaming of mkv files. Mar 11, 2018
daap Updated copyright year. Jun 22, 2017
docs Added 'session_write_close' before modifying cookie parameters for PH… Jul 22, 2018
images Losslessly recompress PNG files and strip comment data using ECT May 20, 2017
lib Added 'session_write_close' before modifying cookie parameters for PH… Jul 22, 2018
locale Latest translation updates and maybe fix for #1738 Aug 13, 2018
modules Cleaning now checks for existing path before removing empty albums/mi… May 6, 2018
nbproject Updated copyright year. Jun 22, 2017
play Removed hardcoded access level for streaming. May 19, 2018
plex Merge pull request #1526 from ibmibmibm/develop Jun 24, 2017
rest cs-fix Jun 10, 2018
scripts Updated .php_cs and .travis.yml for latest php-cs-fixer which modifie… Jul 20, 2017
server updated api to accept both username and apikey. May 4, 2018
sql Updated copyright year. Jun 22, 2017
templates Formatted LF?CRs in artist summary for HTML. Jul 19, 2018
themes/reborn Small changes to make translation easier Nov 9, 2017
upnp Merge pull request #1526 from ibmibmibm/develop Jun 24, 2017
webdav Updated copyright year. Jun 22, 2017
.gitattributes merged all changes from doped Nov 15, 2013
.gitignore Fixed need to check 'Authorization Required' to create channel. Jul 19, 2017
.maintenance.example Add Ampache information in html header to automatically detect ampach… Apr 29, 2015
.php_cs Updated .php_cs and .travis.yml for latest php-cs-fixer which modifie… Jul 20, 2017
.scrutinizer.yml Use Composer for dependencies Sep 13, 2015
.tgitconfig Add TortoiseGit config file Sep 13, 2014
.travis.yml Update .travis.yml Oct 3, 2017
CNAME Add CNAME file to git repository Jun 16, 2014
README.md Added php module requirement for FreeBSD. Jul 21, 2018
albums.php Updated copyright year. Jun 22, 2017
artists.php Updated copyright year. Jun 22, 2017
arts.php updated php-cs-fixer to 2.3.2, .php_cs and scripts/test/* to match ve… Jun 24, 2017
batch.php updated php-cs-fixer to 2.3.2, .php_cs and scripts/test/* to match ve… Jun 24, 2017
broadcast.php Updated copyright year. Jun 22, 2017
browse.php Updated copyright year. Jun 22, 2017
channel.php Fixed need to check 'Authorization Required' to create channel. Jul 19, 2017
composer.json Updated composer.json to install php-cs-fixer ver 2.9.0 to accept php… Dec 24, 2017
composer.lock Updated composer.json to install php-cs-fixer ver 2.9.0 to accept php… Dec 24, 2017
cookie_disclaimer.php Updated copyright year. Jun 22, 2017
crossdomain.xml Fix code style Nov 24, 2013
democratic.php Updated copyright year. Jun 22, 2017
favicon.ico Losslessly recompress PNG files and strip comment data using ECT May 20, 2017
graph.php Updated copyright year. Jun 22, 2017
image.php Updated copyright year. Jun 22, 2017
index.php Updated copyright year. Jun 22, 2017
install.php Updated copyright year. Jun 22, 2017
labels.php Updated copyright year. Jun 22, 2017
localplay.php Updated copyright year. Jun 22, 2017
login.php Updated copyright year. Jun 22, 2017
logout.php Updated copyright year. Jun 22, 2017
lostpassword.php updated php-cs-fixer to 2.3.2, .php_cs and scripts/test/* to match ve… Jun 24, 2017
mashup.php Updated copyright year. Jun 22, 2017
php-cs-fixer Updated composer.json to install php-cs-fixer ver 2.9.0 to accept php… Dec 24, 2017
phpinfo.php Updated copyright year. Jun 22, 2017
playlist.php Updated copyright year. Jun 22, 2017
podcast.php Updated copyright year. Jun 22, 2017
podcast_episode.php Updated copyright year. Jun 22, 2017
preferences.php Updated copyright year. Jun 22, 2017
pvmsg.php Updated copyright year. Jun 22, 2017
radio.php Updated copyright year. Jun 22, 2017
random.php Updated copyright year. Jun 22, 2017
register.php Updated copyright year. Jun 22, 2017
rss.php Updated copyright year. Jun 22, 2017
search.php Updated copyright year. Jun 22, 2017
share.php Updated copyright year. Jun 22, 2017
shout.php Updated copyright year. Jun 22, 2017
show_get.php Updated copyright year. Jun 22, 2017
smartplaylist.php Updated copyright year. Jun 22, 2017
song.php Updated copyright year. Jun 22, 2017
stats.php Updated copyright year. Jun 22, 2017
stream.php Set redirect to false for streaming types. Jan 11, 2018
test.php Updated copyright year. Jun 22, 2017
tvshow_seasons.php Updated copyright year. Jun 22, 2017
tvshows.php Updated copyright year. Jun 22, 2017
update.php updated php-cs-fixer to 2.3.2, .php_cs and scripts/test/* to match ve… Jun 24, 2017
upload.php Updated copyright year. Jun 22, 2017
util.php Updated copyright year. Jun 22, 2017
video.php Updated copyright year. Jun 22, 2017
waveform.php Updated copyright year. Jun 22, 2017
web_player.php Updated copyright year. Jun 22, 2017
web_player_embedded.php Updated copyright year. Jun 22, 2017

README.md

Logo Ampache

www.ampache.org | 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 file name. 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

The recommended and most stable version is git HEAD. Build Status

You get the latest version with recent changes and fixes but maybe in an unstable state from our develop branch. Build Status Scrutinizer Code Quality Codacy Badge Code Climate

Installation

Please see the wiki

Requirements

  • A web server. All of the following have been used, though Apache receives the most testing:

    • Apache
    • lighttpd
    • nginx
    • IIS
  • PHP 5.6 or greater.

  • PHP modules:

    • PDO

    • PDO_MYSQL

    • hash

    • session

    • json

    • simplexml (optional)

    • curl (optional)

    • For FreeBSD The following modules must be loaded:

      • php-xml
      • php-dom
  • MySQL 5.x

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 Affero General Public License v3 (AGPLv3) as published by the Free Software Foundation.

Ampache includes some external modules that carry their own licensing.

Translations

Ampache is currently translated (at least partially) into the following languages. If you are interested in updating an existing translation, simply visit us on Transifex. If you prefer it old school or want to work offline, take a look at /locale/base/TRANSLATIONS for more instructions.

Translation progress so far:

Credits

Thanks to all those who have helped make Ampache awesome: Credits

Contact Us

Hate it? Love it? Let us know! Dozens of people send ideas for amazing new features, report bugs and further develop Ampache actively. Be a part of Ampache with it's more than 10 years long history and get in touch with an awesome and friendly community!

Further Information and basic Help

  • Everything related to the Ampache Project can be found on our Public Repository
  • Want to know, how to get Apache to work or learn more about the functions? See our Documentation

We hope to see you soon and that you have fun with this Project!

Team Ampache