Changes in this release

This version fixes a bug with listing when an album has no tracks.

Installation

Download the archive for your OS below, extract it and
follow the instructions in the README.

This version fixes a bug with listing when an album has no tracks.

Release v1.6.3 Latest

Latest

Compare

Choose a tag to compare

Changes in this release

This release fixes creating a playlist with description.

Installation

Download the archive for your OS below, extract it and
follow the instructions in the README.

Fixes a bug where the description was ignored when set in the API request for creating a brand new playlist.

Release v1.6.2

Compare

Choose a tag to compare

Changes in this release

This release fixes a bug in the URLs generated for browsing songs.

Installation

Download the archive for your OS below, extract it and
follow the instructions in the README.

Release v1.6.1

Compare

Choose a tag to compare

Changes in this release

This one of the biggest improvements of Euterpe so far. As always,
it retains API backwards compatibility with older Euterpe versions.

Subsonic API

This release adds preliminary support of the Subsonic API v1.16.1.
More specifically its Open Subsonic flavour.
The API implementation is not complete yet but is comprehensive
enough for everyday use. What's not yet ready is podcasts, public shares,
bookmarks and some small API endpoints. Keep up with the implementation
progress by watching the src/webserver/subsonic/progress.md file.

The server has been tested with numerous Subsonic clients and the
following have been vetted to work with the current state of the
implementation:

• Supersonic (Linux, Mac, Windows)
• play:Sub (iOS)
• Amperify (iOS)
• Substreamer (iOS)

What is New

• Browsing the library by songs is now possible via the API.
• The API now returns much more data for albums, artists and tracks:
  • Number of plays
  • Time of the last play
  • User rating
  • When an item has been added to a favourites list
  • Track bitrate and album average bitrate
  • Release year for albums and tracks
  • Track size in bytes
• New ways for ordering tracks, albums an artists while browsing:
  • By year when applicable
  • By play frequency
  • By play recency
• A new API endpoints for playlists management have been added
• A new API endpoint /v1/about. It includes information about the
  Euterpe server version.

Bug Fixes

• Artist images are now cleaned up from the database as well
  when an artist entry has been removed.
• The web UI will now properly take advantage of browser caches
  for its static files.
• Improved media tag reading, especially for Vorbis.
• There was a bug which caused some tracks to never be removed
  from the database even though they're no longer on disk. This has been fixed.

Installation

Download the archive for your OS below, extract it and
follow the instructions in the README.

This one of the biggest improvements of Euterpe so far. As always, it retains API backwards compatibility with older Euterpe versions.

Subsonic API

This release adds preliminary support of the Subsonic API v1.16.1. More specifically its Open Subsonic flavour. The API implementation is not complete yet but is comprehensive enough for everyday use. What's not yet ready is podcasts, public shares, bookmarks and some small API endpoints. Keep up with the implementation progress by watching the src/webserver/subsonic/progress.md file.

The server has been tested with numerous Subsonic clients and the following have been vetted to work with the current state of the implementation:

• Supersonic (Linux, Mac, Windows)
• play:Sub (iOS)
• Amperify (iOS)
• Substreamer (iOS)

What is New

• Browsing the library by songs is now possible via the API.
• The API now returns much more data for albums, artists and tracks:
  • Number of plays
  • Time of the last play
  • User rating
  • When an item has been added to a favourites list
  • Track bitrate and album average bitrate
  • Release year for albums and tracks
  • Track size in bytes
• New ways for ordering tracks, albums an artists while browsing:
  • By year when applicable
  • By play frequency
  • By play recency
• A new API endpoints for playlists management have been added
• A new API endpoint /v1/about. It includes information about the Euterpe server version.

Bug Fixes

• Artist images are now cleaned up from the database as well when an artist entry has been removed.
• The web UI will now properly take advantage of browser caches for its static files.
• Improved media tag reading, especially for Vorbis.
• There was a bug which caused some tracks to never be removed from the database even though they're no longer on disk. This has been fixed.

Release v1.6.0

Compare

Choose a tag to compare

Changes in this release

Another release mainly focused on bug fixes.

Bug Fixes

• The uninstall script in the release archive is now working. Previously it was still trying to uninstall "httpms".

• Fixed playing .opus and .mp4 files in the web UI. They are properly tagged as having oga and m4a audio for the purposes of jPlayer.

Installation

Download the archive for your OS below, extract it and
follow the instructions in the README.

Another release mainly focused on bug fixes.

Bug Fixes

• The uninstall script in the release archive is now working. Previously it was still trying to uninstall "httpms".

• Fixed playing .opus and .mp4 files in the web UI. They are properly tagged as having oga and m4a audio for the purposes of jPlayer.

Release v1.5.4

Compare

Choose a tag to compare

Changes in this release

This version focuses on improvements and fixes to the web UI.

What is New

• The state of the "repeat" and "shuffle" buttons is now stored.
  So refreshing the page or coming back after you've closed it will
  not lose their state.

Bug Fixes

• FLAC files were not played on some modern browsers. Notably Brave.
  The problem was the fact that it no longer understands the admittedly
  deprecated audio/x-flac mime type.

• The playlist border is no longer an out-of-place white when the
  dark theme is used on a devices with small screens.

• The album image pop-up would no longer be able to become bigger
  than the viewing window. This was previously possible with
  particularly large artwork.

Installation

Download the archive for your OS below, extract it and
follow the instructions in the README.

This version focuses on improvements and fixes to the web UI.

What is New

• The state of the "repeat" and "shuffle" buttons is now stored. So refreshing the page or coming back after you've closed it will not lose their state.

Bug Fixes

• FLAC files were not played on some modern browsers. Notably Brave. The problem was the fact that it no longer understands the admittedly deprecated audio/x-flac mime type.

• The playlist border is no longer an out-of-place white when the dark theme is used on a devices with small screens.

• The album image pop-up would no longer be able to become bigger than the viewing window. This was previously possible with particularly large artwork.

Release v1.5.3

Compare

Choose a tag to compare

Changes in this release

Another release focused on bug fixes and optimizations.

What is New

• The Euterpe Docker images are now based on Alpine which makes them quite smaller.

• The shuffle button in the web UI will no longer play around with the DOM playlist. Instead it will be a toggle which causes the next played track to be selected at random in the playlist. This greatly improves the functionality with big playlists.

Bug Fixes

• Removed an artificial restriction which caused Euterpe to not be buildable on many operating systems (c6b143b).

• Start recognizing mp4 files as supported.

• Added the -dont-watch option. Without watching the library paths for changes Euterpe will take up a lot less resources such as file descriptors and memory.

Installation

Download the archive for your OS below, extract it and
follow the instructions in the README.

Another release focused on bug fixes and optimizations.

What is New

• The Euterpe Docker images are now based on Alpine which makes them quite smaller.

• The shuffle button in the web UI will no longer play around with the DOM playlist. Instead it will be a toggle which causes the next played track to be selected at random in the playlist. This greatly improves the functionality with big playlists.

Bug Fixes

• Removed an artificial restriction which caused Euterpe to not be buildable on many operating systems (c6b143b).

• Start recognizing mp4 files as supported.

• Added the -dont-watch option. Without watching the library paths for changes Euterpe will take up a lot less resources such as file descriptors and memory.

Release v1.5.2

Compare

Choose a tag to compare

Changes in this release

This release is focused on stability and bugfixes. Most notably, it is the most tested release so far by a wide margain. The code test coverage between 1.5.0 and 1.5.1 has increased from ~40% to ~80%. Even with such a sharp increase in tests no interesting bugs were found in the code base.

What is New

• Support for Opus and WebM was added. Actually there was nothing from preventing previous versions from supporting them but a file extension check. For this version this check has been extended to include .opus and .webm files as well.

Bug Fixes

• Fixed a bug in the web UI filter when selecting an artist was not making the album filter include only albums for this artist.

• The HTTP Basic Authenticate challenge now properly names the software as "Euterpe" instead of "HTTPMS".

• The HTTP Basic Auth credentials checking is now not vulnerable to timing attacks.

• Fixed a bug where on some errors the login API endpoint was not returning JSON but plain text.

• No database entries will be created for album artwork for album IDs which are not already in the database.

• Downloading albums as ZIP will now return HTTP status code 400 instead of 404 when the request was malformed.

Installation

Download the archive for your OS below, extract it and
follow the instructions in the README.

This release is focused on stability and bugfixes. Most notably, it is the most tested release so far by a wide margain. The code test coverage between 1.5.0 has increased from ~40% to ~80%. Even with such a sharp increase in tests no interesting bugs were found in the code base.

What is New

• Support for Opus and WebM was added. Actually there was nothing from preventing previous versions from supporting them but a file extension check. For this version this check has been extended to include .opus and .webm files as well.

Bug Fixes

• Fixed a bug in the web UI filter when selecting an artist was not making the album filter include only albums for this artist.

• The HTTP Basic Authenticate challenge now properly names the software as "Euterpe" instead of "HTTPMS".

• The HTTP Basic Auth credentials checking is now not vulnerable to timing attacks.

• Fixed a bug where on some errors the login API endpoint was not returning JSON but plain text.

• No database entries will be created for album artwork for album IDs which are not already in the database.

• Downloading albums as ZIP will now return HTTP status code 400 instead of 404 when the request was malformed.

Release v1.5.1

Compare

Choose a tag to compare

Changes in this release

What is New

• The project is finally renamed to "Euterpe"! If you have the old version, uninstall it manually as the new installer will not recognize it.

• The web UI playlist has been improved. Everything is neatly ordered now.

• The -local-fs flag was added which allows using assets from the file system instead of the bundled into the binary static files.

Bug fixes

• The artwork view in the web UI is finally a square so most common album artworks are now fully visible.

Installation

Download the archive for your OS below, extract it and
follow the instructions in the README.

What is New

• The project is finally renamed to "Euterpe"! If you have the old version, uninstall it manually as the new installer will not recognize it.

• The web UI playlist has been improved. Everything is neatly ordered now.

• The -local-fs flag was added which allows using assets from the file system instead of the bundled into the binary static files.

Bug fixes

• The artwork view in the web UI is finally a square so most common album artworks are now fully visible.

Release v1.5.0

Compare

Choose a tag to compare

• Show album artwork in the web UI.
• Cleanup database on startup. Artists and albums without tracks are removed.

• Connecting with devices via QR code is now possible.
• Explicitly show which format a media file is in the web UI.

Two small bug fixes:

• A regression in config parsing where duration values (such as "20ms") could not be parsed.

• Fix a bug where the address scheme in generated QR barcode is always http.

Added a page for generating token in a QR barcode suitable for scaning in the HTTPMS mobile app.

Album artwork support is added into the server. Now artwork will be searched on disk or if configured - using the Cover Art Archive. For this new API endpoints are created for working with the artwork.

All static files are bundled into the binary. This makes installation and uninstallation easier. On top of that because we now use upx the binary is much smaller than before. Apparently "more is less" contrary to what commander Pike says.

When configured with authentication HTTPMs will now have 3 new options for authentication with JWT tokens: HTTP cookie, Authorization: Bearer and via query parameter token. At the moment there is no public API for generating tokens but the interactive web login.

On the development front - dependencies are now vendored using dep instead of govendor. Also, from this version forward releases will be made from the master branch instead of release/X branches. The latter will be abandoned.

A new API endpoint is included: /browse/. Using it one can browse through all artists or albums in paginated manner. See here for its full documentation.

Changes

• Changed the library for scanning mp3 files meta information. This would hopefully improve the accuracy.

• The web UI now supports multiple albums with the same name. They would be individually listed in the album filter.

New Stuff

• Now one can share search, artist and album selections, along with the currently playing track by just copying the URL.

• The UI is greatly improved on devices with small screens. This comes on the cost of exclusion of some features. On such devices one wouldn't be able to use suffle and repeat. Also, no direct download of albums or tracks. The main reason for these ommisions is that the original jPlayer theme was completely unaware of small devices. Future patches may bring the features back.

Bug fixes

Fixed a bug where an album by multiple artists would not be downloadable in bulk. This was because all albums were assumed to by one artist only. This means that there were actually a different album (with the same name) for every atist. Which in turn means that by downloading such an album, you would get only the songs for the particular artist.

Bug fixes

• Fixed a bug where track attributes were jumbled while scanning a library. The effect of this bug were tracks with wrong data for album, track number, title or artist.

What's new?

• This version have its dependencies vendored. All the code required for building it can be found in the release.

The first tagged version.