Skip to content

ampache/ampache

develop
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
.tx
 
 
bin
 
 
 
 
 
 
 
 
 
 
 
 
 
 
src
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Ampache

Logo

www.ampache.org

Ampache Docker

News

Ampache6 is about to shake up the develop branch. Keep track using the wiki

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 the current stable release5 branch.

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

If you want to run the last stable version release4 is still available

Installation

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

Requirements

  • 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-7.4 (Ampache 4.x.x)

  • PHP 7.4 (Ampache 5.0.x and higher)

  • PHP 8.0 (Ampache 5.1.x and higher)

  • PHP 8.1 (Ampache 5.5.0 and higher)

NOTE That php7.4 will not be released for Ampache6 but can still be used.

  • PHP modules:

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

    • php-xml
    • php-dom
    • php-intl
  • MySQL 5.x / MySQL 8.x / MariaDB 10.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 (AGPL-3.0-or-later) 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:

Transifex

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

About

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.

Resources

License

Security policy

Stars

Watchers

Forks