My fork of airsonic with experimental fixes and improvements. See branch "custom"
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
Tom Powell 705a3d80b7 Make libresonic build again. (#149) 8 years ago
contrib Add deploy helper script 9 years ago
documentation Libresonic v6.1.beta2 8 years ago
libresonic-assembly Libresonic v6.1.beta2 8 years ago
libresonic-booter Make libresonic build again. (#149) 8 years ago
libresonic-installer-debian Libresonic v6.1.beta2 8 years ago
libresonic-installer-mac Libresonic v6.1.beta2 8 years ago
libresonic-installer-rpm Libresonic v6.1.beta2 8 years ago
libresonic-installer-windows Libresonic v6.1.beta2 8 years ago
libresonic-main Make libresonic build again. (#149) 8 years ago
libresonic-rest-api Libresonic v6.1.beta2 8 years ago
libresonic-sonos-api Libresonic v6.1.beta2 8 years ago
libresonic-tools Subsonic-->Libresonic regex 9 years ago
libresonic-transcode s/SUBSONIC/LIBRESONIC 9 years ago
repo First commit 9 years ago
.gitignore Updated gitignore for intellij 8 years ago
.travis.yml Add Travis CI configuration 8 years ago
BUILD.md Document how to generate release archives 8 years ago
CHANGELOG.md Libresonic v6.1.beta2 8 years ago
CONTRIBUTING.md Update CONTRIBUTING, again. 9 years ago
INSTALL.md Libresonic v6.1.beta2 8 years ago
ISSUE_TEMPLATE.md Import current state of 5.3-kang branch 9 years ago
LICENSE.txt Added license 9 years ago
MIGRATE.md Added MIGRATE.md for migrating from Subsonic 8 years ago
PULL_REQUEST_TEMPLATE.md Import current state of 5.3-kang branch 9 years ago
README.md Typofix 9 years ago
pom.xml Make libresonic build again. (#149) 8 years ago

README.md

Libresonic

What is Libresonic?

Libresonic is a free, web-based media streamer, providing ubiqutious access to your music. Use it to share your music with friends, or to listen to your own music while at work. You can stream to multiple players simultaneously, for instance to one player in your kitchen and another in your living room.

Libresonic is designed to handle very large music collections (hundreds of gigabytes). Although optimized for MP3 streaming, it works for any audio or video format that can stream over HTTP, for instance AAC and OGG. By using transcoder plug-ins, Libresonic supports on-the-fly conversion and streaming of virtually any audio format, including WMA, FLAC, APE, Musepack, WavPack and Shorten.

If you have constrained bandwidth, you may set an upper limit for the bitrate of the music streams. Libresonic will then automatically resample the music to a suitable bitrate.

In addition to being a streaming media server, Libresonic works very well as a local jukebox. The intuitive web interface, as well as search and index facilities, are optimized for efficient browsing through large media libraries. Libresonic also comes with an integrated Podcast receiver, with many of the same features as you find in iTunes.

Based on Java technology, Libresonic runs on most platforms, including Windows, Mac, Linux and Unix variants.

History

The original Subsonic is developed by Sindre Mehus. Subsonic was open source through version 6.0-beta1, and closed-source from then onwards.

Libresonic is maintained by Eugene E. Kashpureff Jr. It originated as an unofficial("Kang") of Subsonic which did not contain the Licensing code checks present in the official builds. With the announcement of Subsonic's closed-source future, a decision was made to make a full fork and rebrand to Libresonic.

Libresonic will strive to maintain compatibility and stability for Subsonic users, including a clean upgrade path. New features and refactoring are welcomed as a Pull Request on Github.

License

Libresonic is free software and licensed under the GNU General Public License version 3. The code in this repository(and associated binaries) are free of any "license key" or other restrictions. If you wish to thank the maintainer of this repository, please consider a donation to the Electronic Frontier Foundation.

The Subsonic source code was released under the GPLv3 through version 6.0-beta1. Beginning with 6.0-beta2, source is no longer provided. Binaries of Subsonic are only available under a commercial license. There is a Subsonic Premium service which adds functionality not available in Libresonic. Subsonic also offers RPM, Deb, Exe, and other pre-built packages that Libresonic currently does not.

Usage

Libresonic can be downloaded from Github for personal usage. Packagers can reference the release repository, but please contact the maintainer or wait until a stable release policy is available.

Libresonic is packaged in WAR format, suitable for deployment as a webapp under Tomcat. Comprehensive install documentation is pending.

Please see the INSTALL document for instructions on building from source.