ampache  4.4.3
About: Ampache is an universal web based audio/video streaming application and file manager.
  Fossies Dox: ampache-4.4.3.tar.gz  ("unofficial" and yet experimental doxygen-generated source code documentation)  

ampache Documentation

Some Fossies usage hints in advance:

  1. To see the Doxygen generated documentation please click on one of the items in the steelblue colored "quick index" bar above or use the side panel at the left which displays a hierarchical tree-like index structure and is adjustable in width.
  2. If you want to search for something by keyword rather than browse for it you can use the client side search facility (using Javascript and DHTML) that provides live searching, i.e. the search results are presented and adapted as you type in the Search input field at the top right.
  3. Doxygen doesn't incorporate all member files but just a definable subset (basically the main project source code files that are written in a supported language). So to search and browse all member files you may visit the Fossies ampache-4.4.3.tar.gz contents page and use the Fossies standard member browsing features (also with source code highlighting and additionally with optional code folding).


Logo |


  • Keep an eye on the incoming changes to develop branch at Ampache-Next-Changes
  • The Ampache kodi plugin has merged into the official Kodi addons repo!
  • Make sure you enable hide_search in your config to enable playlists in this initial version.
  • Develop changes
    • DATABASE CHANGES You can now force a default collation and charset on your database. (Read the changelog!)
    • Develop branch now has a mandatory requirement of php-intl for date formatting.
    • The initial development version of api 5.0.0 has been released! Please go over the changes on the website!
  • Get your album/artist art right from Spotify's web API. Go to the dashboard
    • Then put your client ID and secret in your ampache config
    • And don't forget to set your art order! (art_order = "db,tags,folder,spotify,musicbrainz")


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.

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


Please see the wiki and don't forget to check out the basic config guide after that.


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

    • Apache
    • lighttpd
    • nginx
    • IIS
  • PHP 7.1 or greater. (Currently tested on php7.4-fpm)

  • PHP modules:

    • PDO
    • hash
    • session
    • json
    • intl (Ampache develop)
    • simplexml (optional)
    • curl (optional)
  • For FreeBSD The following php modules must be loaded:

    • php-xml
    • php-dom
    • php-intl (Ampache develop)
  • MySQL 5.x / MySQL 8.x / MariaDB 10.x


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, /channel/.htaccess, and /play/.htaccess files if any. All database updates will be handled by Ampache.


Ampache is free software; you can redistribute it and/or modify it under the terms of the GNU Affero General Public License v3 (AGPL-3.0-or-later) as published by the Free Software Foundation.

Ampache includes some external modules that carry their own licensing.


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:



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