{"id":13455071,"url":"https://github.com/Mastermindzh/tidal-hifi","last_synced_at":"2025-03-24T07:32:24.326Z","repository":{"id":37042713,"uuid":"208899012","full_name":"Mastermindzh/tidal-hifi","owner":"Mastermindzh","description":"The web version of Tidal running in electron with hifi support thanks to widevine.","archived":false,"fork":false,"pushed_at":"2025-03-22T09:10:51.000Z","size":9116,"stargazers_count":1206,"open_issues_count":62,"forks_count":65,"subscribers_count":12,"default_branch":"master","last_synced_at":"2025-03-22T09:28:17.427Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Mastermindzh.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-09-16T21:12:46.000Z","updated_at":"2025-03-22T02:53:13.000Z","dependencies_parsed_at":"2023-09-22T14:17:11.614Z","dependency_job_id":"30b2d2b3-768b-4d4a-9c4b-3523ad236e85","html_url":"https://github.com/Mastermindzh/tidal-hifi","commit_stats":null,"previous_names":[],"tags_count":59,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mastermindzh%2Ftidal-hifi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mastermindzh%2Ftidal-hifi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mastermindzh%2Ftidal-hifi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mastermindzh%2Ftidal-hifi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Mastermindzh","download_url":"https://codeload.github.com/Mastermindzh/tidal-hifi/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245227569,"owners_count":20580898,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-07-31T08:01:00.993Z","updated_at":"2025-03-24T07:32:22.787Z","avatar_url":"https://github.com/Mastermindzh.png","language":"TypeScript","funding_links":["https://github.com/sponsors/Mastermindzh"],"categories":["Applications","TypeScript","应用","others"],"sub_categories":["Audio","音频"],"readme":"# TIDAL Hi-Fi (Max quality)\u003cimg src = \"./build/icon.png\" height=\"40\" align=\"right\"/\u003e\n\n![GitHub release](https://img.shields.io/github/release/Mastermindzh/tidal-hifi.svg) [![github builds](https://github.com/mastermindzh/tidal-hifi/actions/workflows/build.yml/badge.svg)](https://github.com/Mastermindzh/tidal-hifi/actions) [![Build Status](https://ci.mastermindzh.tech/api/badges/Mastermindzh/tidal-hifi/status.svg)](https://ci.mastermindzh.tech/Mastermindzh/tidal-hifi) [![Discord logo](./docs/images/discord.png)](https://discord.gg/yhNwf4v4He)\n\nThe web version of [listen.tidal.com](https://listen.tidal.com) running in electron with Hi-Fi (High \u0026 Max) support thanks to widevine.\n\n![TIDAL Hi-Fi preview](./docs/images/preview.png)\n\n## Table of Contents\n\n\u003c!-- toc --\u003e\n\n- [TIDAL Hi-Fi (Max quality)](#tidal-hi-fi-max-quality)\n  - [Table of Contents](#table-of-contents)\n  - [Features](#features)\n  - [Contributions](#contributions)\n  - [Why did I create TIDAL Hi-Fi?](#why-did-i-create-tidal-hi-fi)\n    - [Why not extend existing projects?](#why-not-extend-existing-projects)\n  - [Installation](#installation)\n    - [Dependencies](#dependencies)\n    - [Using releases](#using-releases)\n    - [Snap](#snap)\n    - [Arch Linux](#arch-linux)\n    - [Flatpak](#flatpak)\n    - [Nix](#nix)\n    - [Using source](#using-source)\n  - [Integrations](#integrations)\n  - [Known bugs](#known-bugs)\n    - [DRM not working on Windows (error S6007)](#drm-not-working-on-windows-error-s6007)\n  - [Special thanks to](#special-thanks-to)\n  - [Donations](#donations)\n  - [Images](#images)\n    - [Settings window](#settings-window)\n    - [User setups](#user-setups)\n\n\u003c!-- tocstop --\u003e\n\n## Features\n\n- HiFi playback (High \u0026 Max settings)\n- Notifications\n- Custom [theming](./docs/theming.md)\n- Custom hotkeys ([source](https://defkey.com/tidal-desktop-shortcuts))\n- Better icons thanks to [Papirus-icon-theme](https://github.com/PapirusDevelopmentTeam/papirus-icon-theme/)\n- [Settings feature](./docs/images/settings.png) to disable certain functionality. (`ctrl+=` or `ctrl+0`)\n- API for status, playback and settings (see the [/docs](http://localhost:47836/docs/) route)\n- Disabled audio \u0026 visual ads, unlocked lyrics, suggested track, track info, and unlimited skips thanks to uBlockOrigin custom filters ([source](https://github.com/uBlockOrigin/uAssets/issues/17495))\n- AlbumArt in integrations ([best-effort](https://github.com/Mastermindzh/tidal-hifi/pull/88#pullrequestreview-840814847))\n- Custom [integrations](#integrations)\n  - [ListenBrainz](https://listenbrainz.org/?redirect=false) integration\n  - Discord RPC integration (showing \"now listening\", \"Browsing\", etc)\n    - Flatpak version only works if both Discord and Tidal-HiFi are flatpaks\n  - MPRIS integration\n- UI + Json config (`~/.config/tidal-hifi/`, or `~/.var/app/com.mastermindzh.tidal-hifi/` for Flatpak)\n\n## Contributions\n\nTo contribute you can use the standard GitHub features (issues, prs, etc.) or join the discord server to talk with like-minded individuals.\n\n- ![Discord logo](./docs/images/discord.png) [Join the Discord server](https://discord.gg/yhNwf4v4He)\n\n## Why did I create TIDAL Hi-Fi?\n\nI moved from Spotify over to Tidal and found Linux support to be lacking.\nWhen I started this project there weren't any Linux apps that offered Tidal's \"hifi\" options nor any scripts to control it.\nI made this app to support the highest quality audio available on the Linux platform. It used to be \"hifi\" but now is [\"High \u0026 Max\"](https://tidal.com/sound-quality).\n\n### Why not extend existing projects?\n\nWhilst there are a handful of projects attempting to run Tidal on Electron they are all unappealing to me because of various reasons:\n\n- Lack of maintainers/developers. (no hotfixes, no issues being handled etc)\n- Most are simple web wrappers, not my cup of tea.\n- Some are DE-oriented. I want this to work on WM's too.\n- None have Widevine working at the moment\n\nSometimes it's just easier to start over, cover my own needs and after that making it available to the public :)\n\n## Installation\n\n### Dependencies\n\nNote that you **need** a notification library such as [libnotify](https://github.com/GNOME/libnotify) or [dunst](https://github.com/dunst-project/dunst) for the software to work properly.\n\n### Using releases\n\nVarious packaged versions of the software are available on the [releases](https://github.com/Mastermindzh/tidal-hifi/releases) tab.\n\n### Snap\n\nTo install with `snap` you need to download the pre-packaged snap-package from this repository, found under releases:\n\n1. Download\n\n   ```sh\n   wget \u003cURI\u003e #for instance: https://github.com/Mastermindzh/tidal-hifi/releases/download/1.0/tidal-hifi_1.0.0_amd64.snap\n   ```\n\n2. Install\n\n   ```sh\n   snap install --dangerous \u003cpath\u003e #for instance: tidal-hifi_1.0.0_amd64.snap\n   ```\n\n### Arch Linux\n\nArch Linux users can use the AUR to install TIDAL Hi-Fi:\n\n```sh\ntrizen tidal-hifi-git\n```\n\n### Flatpak\n\nTo install via [Flatpak](https://flathub.org/apps/details/com.mastermindzh.tidal-hifi) run the following command:\n\n```sh\nflatpak install flathub com.mastermindzh.tidal-hifi\n```\n\n### Nix\n\nTo install with Nix run the following command:\n\n```sh\nnix-env -iA nixpkgs.tidal-hifi\n```\n\n### Using source\n\nTo install and work with the code on this project follow these steps:\n\n- `git clone https://github.com/Mastermindzh/tidal-hifi.git`\n- `cd tidal-hifi`\n- `npm install`\n- `npm run watch` to watch for auto-reload of Typescript/SCSS changes.\n  - `npm run compile` can be used to trigger it once\n- `npm watchStart` to auto watch for any updates files and reload Tidal Hi-Fi\n  - `npm start` can be used to run Tidal Hi-Fi manually once\n\n## Integrations\n\nTIDAL Hi-Fi comes with several integrations out of the box.\nYou can find these in the settings menu (`ctrl + =` by default) under the \"integrations\" tab.\n\n![integrations menu, showing a list of integrations](./docs/images/integrations.png)\n\nIntegrations with other projects that are not included natively:\n\n- [i3 blocks config](https://github.com/Mastermindzh/dotfiles/commit/9714b2fa1d670108ce811d5511fd3b7a43180647) - My dotfiles where I use this app to fetch currently playing music (direct commit)\n- [neptune](https://github.com/uwu/neptune) third party plugins \u0026 theming\n\n## Known bugs\n\n### DRM not working on Windows (error S6007)\n\nMost Windows users run into DRM issues when trying to use TIDAL Hi-Fi.\nNothing I can do about that I'm afraid... Tidal is working on removing/changing DRM so when they finish with that we can give it another shot.\n\nUntil then you'll have to use the official app unfortunately.\n\n## Special thanks to\n\n- [Castlabs](https://castlabs.com/)\n  For maintaining Electron with Widevine CDM installation, Verified Media Path (VMP), and persistent licenses (StorageID)\n\n## Donations\n\nYou can find my Github sponsorship page at: [https://github.com/sponsors/Mastermindzh](https://github.com/sponsors/Mastermindzh)\n\n## Images\n\n### Settings window\n\n![settings window](./docs/images/settings-preview.png)\n\n### User setups\n\nSome of our users are kind enough to share their usage pictures.\nIf you want to see them or possibly even add one please do so in the following issue: [#3 - image thread](https://github.com/Mastermindzh/tidal-hifi/issues/3).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMastermindzh%2Ftidal-hifi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FMastermindzh%2Ftidal-hifi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMastermindzh%2Ftidal-hifi/lists"}