Tina/hifi
1
0
Fork 0
mirror of https://github.com/sachinsenal0x64/hifi.git synced 2025-12-03 20:54:50 +00:00
Code Issues Projects Releases Packages Wiki Activity
🎵 Tidal Music integration for Subsonic/Jellyfin/Plexamp. https://hifi.401658.xyz
54 commits 1 branch 0 tags 38 MiB
Find a file
Exact
0x64 8a38c66b4b Refactor layout classes for improved responsiveness in +page.svelte
2025-12-04 02:48:50 +08:00
.github Initial commit 2025-11-23 19:01:03 +08:00
config Comment out salt environment variable in config 2025-11-23 23:43:46 +08:00
middleware Fix GetTopItems to read response body correctly and update item extraction count 2025-12-02 20:37:16 +08:00
routes Initial commit 2025-11-23 19:01:03 +08:00
types Refactor AppGet type to be a slice and remove unused tags in create_user middleware 2025-11-23 22:28:20 +08:00
web Refactor layout classes for improved responsiveness in +page.svelte 2025-12-04 02:48:50 +08:00
.dockerignore Initial commit 2025-11-23 19:01:03 +08:00
.gitignore Initial commit 2025-11-23 19:01:03 +08:00
CONTRIBUTING.md Update CONTRIBUTING.md 2025-11-25 16:13:53 +08:00
Dockerfile Initial commit 2025-11-23 19:01:03 +08:00
go.mod Bump golang.org/x/crypto in the go_modules group across 1 directory 2025-11-24 00:38:15 +08:00
go.sum Bump golang.org/x/crypto in the go_modules group across 1 directory 2025-11-24 00:38:15 +08:00
LICENSE Initial commit 2025-11-23 19:01:03 +08:00
main.go Initial commit 2025-11-23 19:01:03 +08:00
pnpm-lock.yaml Initial commit 2025-11-23 19:01:03 +08:00
pnpm-workspace.yaml Initial commit 2025-11-23 19:01:03 +08:00
README.md Initial commit 2025-11-23 19:01:03 +08:00
SECURITY.md Initial commit 2025-11-23 19:01:03 +08:00

README.md

Hifi

🎵 Tidal Music integration for Subsonic/Jellyfin/Plexamp.

hifi tidal
hifi tidal

HiFi running on - Feishin Web UI

hifi tidal



💕 Community

🍻 Join the community: Discord


Quickstart

hifi tidal

Note

Create your HiFi account here, and then use the account with supported Subsonic client.


Jellyfin Music Clients Support (WIP)

Important

ETA — It is developed in my free time, and the next major update is Jellyfin support nothing else, so there is no actual ETA for it.

HiFi Subsonic compatibility will only work with Feishin, SubStreamer, and Ultrasonic. All future updates will be exclusive to those apps. If HiFi does not work with the Subsonic client, it will not be implemented.

I’m going to support https://www.plex.tv/plexamp. It’s not a new thing I just forgot to add it. I forgot about Plex itself when I moved to Jellyfin, so I won’t support any other third-party Plex apps. It will be exclusive to the official Plexamp app.

The following jellyfin music clients will continue to be compatible with HiFi from the day one release and will remain fully functional unless the app itself is broken.

All other clients should work as well, since they all use Jellyfin’s API. If they don’t, I will eventually make them work. If you want to request support for a specific jellyfin music app, open an issue. Before doing so, please check the HiFi proposal guide below. Anything else that comes without a hifi proposal check will be rejected.


Important

Project Terms

  • We do not encourage piracy. This project is made purely for educational and personal use, intended only for listening, not for downloading. If you somehow download copyrighted content, you are solely responsible for complying with the relevant laws in your country.

  • The HiFi Project assumes no responsibility for any misuse or legal violations arising from the use of this project.

  • HiFi project requires a valid Tidal subscription. We encourage users to maintain an active subscription.

  • The subsonic client use the maximum quality available from the HiFi API.

  • Community projects may be inspired by or related to the HiFi Project but aren’t officially part of it. These projects are run independently, and the HiFi team isn’t responsible for their content or actions. Each project team should follow any relevant laws and handle its own checks and compliance.

  • The HiFi project does not claim ownership of any music or audio content. All rights remain with their respective copyright holders. Users are encouraged to support artists and rights owners by maintaining a valid Tidal subscription. HiFi serves solely as a playback and control interface (e.g., on a Raspberry Pi) for personal, non-commercial use.


Note

Hifi project is for

  • Tidal subscribers who don’t like the official app and want more client options.

  • Anyone who want to try Tidal music before making a commitment.

  • Anyone who wants to listen to hifi-res lossless audio.

  • Anyone who doesn’t want to store terabytes of music.

  • Anyone who want to access over 110 million songs through their Subsonic-based client.

  • Anyone who doesn’t need to download and manually add tracks.

  • Developers who want to create their own Subsonic-based client using HiFi as a tidal proxy.


Note

HiFi proposal check

hifi tidal

API

API Docs | Hosted API

How can I create my own app based on HiFi?

First, check which routes are supported by Hifi. Hifi uses OpenSubsonic API, but that doesn’t mean it supports every endpoint that OpenSubsonic provides. Hifi only supports the necessary endpoints required to play music. For example, You can connect the Hifi server to Feishin to observe how it works in practice.


Installation (Self-host Hifi)

Pending...

Reason: The current installation is a little bit complex, so I will make this as simple as possible.


Contributing

Please refer to CONTRIBUTING.md.

Security Policy

Please refer to SECURITY.md.

License

Hifi is released under the MIT License.