2019-11-03 11:18:01 +01:00
< h1 >
Tidal-hifi
2019-11-03 18:52:15 +01:00
< img src = "./build/icon.png" height = "40" align = "right" / >
2019-11-03 11:18:01 +01:00
< / h1 >
2019-09-16 23:13:12 +02:00
The web version of [listen.tidal.com ](listen.tidal.com ) running in electron with hifi support thanks to widevine.
2019-10-20 22:47:01 +02:00
2019-11-03 11:18:01 +01:00
## Table of contents
2019-09-16 23:13:12 +02:00
<!-- toc -->
2019-10-20 22:47:01 +02:00
- [Installation ](#installation )
- [Using releases ](#using-releases )
2020-04-09 17:02:49 +02:00
- [Snap install ](#snap-install )
2021-01-10 13:53:34 +01:00
- [Arch Linux ](#arch-linux )
2019-10-20 22:47:01 +02:00
- [Using source ](#using-source )
2019-11-03 18:52:15 +01:00
- [features ](#features )
2019-09-16 23:13:12 +02:00
- [Integrations ](#integrations )
2021-04-25 18:32:52 +02:00
- [not included ](#not-included )
2021-01-10 13:53:34 +01:00
- [Known bugs ](#known-bugs )
2019-11-03 11:18:01 +01:00
- [Why ](#why )
2019-10-20 22:47:01 +02:00
- [Why not extend existing projects? ](#why-not-extend-existing-projects )
2021-01-10 13:53:34 +01:00
- [Special thanks to... ](#special-thanks-to )
- [Buy me a coffee? Please don't ](#buy-me-a-coffee-please-dont )
- [Images ](#images )
- [settings window ](#settings-window )
- [user setups ](#user-setups )
2019-09-16 23:13:12 +02:00
<!-- tocstop -->
2019-10-20 22:47:01 +02:00
## Installation
2019-09-16 23:13:12 +02:00
2019-10-20 22:47:01 +02:00
### Using releases
Various packaged versions of the software are available on the [releases ](https://github.com/Mastermindzh/tidal-hifi/releases ) tab.
2020-04-09 17:02:49 +02:00
#### Snap install
To install with `snap` you need to download the pre-packaged snap-package from this repository, found under releases:
2021-04-25 18:32:52 +02:00
1. Download
2020-10-04 11:52:08 +02:00
```sh
2020-04-09 17:02:49 +02:00
wget < URI > #for instance: https://github.com/Mastermindzh/tidal-hifi/releases/download/1.0/tidal-hifi_1.0.0_amd64.snap
```
2021-04-25 18:32:52 +02:00
2. Install
2020-10-04 11:52:08 +02:00
2020-04-09 17:02:49 +02:00
```sh
snap install --dangerous < path > #for instance: tidal-hifi_1.0.0_amd64.snap
```
2019-12-02 22:55:10 +01:00
### Arch Linux
Arch Linux users can use the AUR to install tidal-hifi:
```sh
trizen tidal-hifi
```
2019-10-20 22:47:01 +02:00
### Using source
To install and work with the code on this project follow these steps:
2021-04-25 18:32:52 +02:00
- git clone [https://github.com/Mastermindzh/tidal-hifi.git ](https://github.com/Mastermindzh/tidal-hifi.git )
2019-10-20 22:47:01 +02:00
- cd tidal-hifi
- npm install
- npm start
2019-11-03 18:52:15 +01:00
## features
- HiFi playback
- Notifications
2021-01-10 13:52:22 +01:00
- Custom hotkeys ([source](https://defkey.com/tidal-desktop-shortcuts))
2019-11-03 18:52:15 +01:00
- API for status and playback
2021-04-25 18:32:52 +02:00
- Custom [integrations ](#integrations )
2021-01-10 13:52:22 +01:00
- [Settings feature ](./docs/settings.png ) to disable certain functionality. (`ctrl+=`)
2019-11-03 18:52:15 +01:00
2019-11-03 11:18:01 +01:00
## Integrations
2021-04-25 18:32:52 +02:00
Tidal-hifi comes with several integrations out of the box.
You can find these in the settings menu (`ctrl + =` by default) under the "integrations" tab.
It currently includes:
- mpris - mpris media player controls/status
- Discord - Shows what you're listening to on Discord.
### not included
2019-11-03 11:18:01 +01:00
- [i3 blocks config ](https://github.com/Mastermindzh/dotfiles/commit/9714b2fa1d670108ce811d5511fd3b7a43180647 ) - My dotfiles where I use this app to fetch currently playing music (direct commit)
2020-01-18 12:10:49 +01:00
### Known bugs
2020-10-04 11:52:08 +02:00
2020-01-18 12:10:49 +01:00
- [Last.fm login doesn't work ](https://github.com/Mastermindzh/tidal-hifi/issues/4 ).
2019-10-20 22:47:01 +02:00
## Why
2019-09-16 23:13:12 +02:00
2019-10-20 22:47:01 +02:00
I moved from Spotify over to Tidal and found Linux support to be lacking.
2019-09-16 23:13:12 +02:00
2019-10-20 22:47:01 +02:00
When I started this project there weren't any Linux apps that offered Tidal's "hifi" options nor any scripts to control it.
2019-09-16 23:13:12 +02:00
2019-10-20 22:47:01 +02:00
## Why not extend existing projects?
Whilst there are a handful of projects attempting to run Tidal on Electron they are all unappealing to me because of various reasons:
- Lack of a maintainers/developers. (no hotfixes, no issues being handled etc)
- Most are simple web wrappers, not my cup of tea.
- Some are DE oriented. I want this to work on WM's too.
2019-11-03 11:18:01 +01:00
- None have widevine working at the moment
2019-10-20 22:47:01 +02:00
Sometimes it's just easier to start over, cover my own needs and then making it available to the public :)
2020-10-07 20:10:31 +02:00
## Special thanks to...
2019-10-20 22:47:01 +02:00
- [Castlabs ](https://castlabs.com/ )
For maintaining Electron with Widevine CDM installation, Verified Media Path (VMP), and persistent licenses (StorageID)
2020-10-07 20:10:31 +02:00
## Buy me a coffee? Please don't
2020-10-07 20:33:39 +02:00
Instead spend some money on a charity I care for: [kwf.nl ](secure.kwf.nl/donation ).
2020-10-07 20:10:31 +02:00
Inspired by [haydenjames' issue ](https://github.com/Mastermindzh/tidal-hifi/issues/27#issuecomment-704198429 )
2021-01-10 13:53:34 +01:00
## Images
### settings window
### user setups
Some of our users are kind enough to share their usage pictures.
If 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 ).
