hifi tui
1.0.0
? Join the community: Discord
We DO NOT encourage piracy and made for purely educational purposes / personal use / just for listen not for downloading.
I'm currently paying for a Tidal HiFi Plus subscription.
We Dont have any GUI Application for android / ios / windows / mac / linux contributors are welcome.
You can access our rest api for free if you want to self-host then need tidal subscription.
TUI is plug & play also you can add your own tidal account but by default it has our API so you can listen tidal music for free.
TL;DR HIFI API Can Get Any Quality & Codec Which Tidal Offer / Some Qualities & Codecs Need Special Driver / Song / Hardware to get maximum output i always recommend to use
HI_RESorLOSSLESSboth are in flac.
MQA-CHECKER
Low (96 kbps) - 3 MB | Low (320 kbps) - 8 MB | High (FLAC, 16-bit, 44.1 kHz) - 30 MB | Max (MQA) - 26 MB | Max (MQA) - 26 | Max (HiRes FLAC, up to 24-bit, 192 kHz) - 30 MB to 140 MB
Currently We don't have any GUI Application for android / ios / windows / mac / linux contributors are welcome.
I love cli tools as well as music, so why not to have a tidal music client for the terminal? Unfortunately, I haven't found any terminal client yet, and that's why it's all about :)
Tidal Current Situation.
Features
|
Note
TUI based on this api and it free & opensource.
https://tidal.401658.xyz
https://status.401658.xyz
Note
Tui player based on reverse api so its totally free (you can listen without any premium subscription) and easy to install via package manager
(⭕ WIP)
(⭕ WIP)
Note
This Required Tidal subscription / Redis & Fill the .env file. / Grab Tokens and Ids Using tidal_auth.py
Tip
You can access reverse api for free.
# Clone the Repo
https://github.com/sachinsenal0x64/hifi-tui
# Rename .env-example
cd hifi-tui/api
mv .env-example .env
# Run the Docker contaer
docker pull sachinsenal/hifi-proxy
docker run --env-file .env -p 8000:8000 hifi-tui
# Clone the Repo
https://github.com/sachinsenal0x64/host-hifi-restapi-on-vercel
# Rename .env-example
cd host-hifi-restapi-on-vercel
mv .env-example .env
# Run the Docker contaer
docker-compose up# Clone the Repo
https://github.com/sachinsenal0x64/host-hifi-restapi-on-vercel
# Rename .env-example
cd host-hifi-restapi-on-vercel
mv .env-example .env
# Build the Docker image
docker build -t host-hifi-restapi-on-vercel .
# Run the Docker contaer
docker run --env-file .env -p 8000:8000 host-hifi-restapi-on-vercel
git clone https://github.com/sachinsenal0x64/hifi-tui
cd hifi-tui
cd api
mv env-example .env
pip install "fastapi[all]"
pip install -r requirements.txt
python main.py
GET /track/
Parameter Type Description idinteger Track Id = 286266926qualitystring Song Quality = HI_RES_LOSSLESSorHI_RESorLOSSLESSorHIGHorLOW
HTTPie
https GET "https://tidal.401658.xyz/track/?id=286266926&quality=LOSSLESS"
{
"albumPeakAmplitude": 1.0,
"albumReplayGain": -9.18,
"assetPresentation": "FULL",
"audioMode": "STEREO",
"audioQuality": "LOSSLESS",
"bitDepth": 16,
"manifest": "base64 manifest",
"manifestMimeType": "application/vnd.tidal.bts",
"sampleRate": 44100,
"trackId": 286266926,
"trackPeakAmplitude": 0.988482,
"trackReplayGain": -7.89
},
{
"originalTrack": "aka song track"
}HIFI returns the following status codes in its API:
Status Code Description 200 OK422 UNPROCESSABLE CONTENT404 NOT FOUND500 INTERNAL SERVER ERROR
GET /search/
Parameter Type Description sstring Name = Spaceshipastring Artist Name = Kanye Westalstring Album Name = Late Registrationvstring Video Name = Spaceshippstring Playlist Name = Pop Hits
HTTPie
https GET "https://tidal.401658.xyz/search/?s=Consequence"
{
"limit": 1,
"offset": 0,
"totalNumberOfItems": 200,
"items": [
{
"id": 82448461,
"title": "Consequence",
"duration": 313,
"replayGain": -9.88,
"peak": 1,
"allowStreaming": true,
"streamReady": true,
"streamStartDate": "2017-12-05T00:00:00.000+0000",
"premiumStreamingOnly": false,
"trackNumber": 10,
"volumeNumber": 1,
"version": null,
"popularity": 6,
"copyright": "City Slang/big Store",
"url": "http://www.tidal.com/track/82448461",
"isrc": "DED620118410",
"editable": false,
"explicit": false,
"audioQuality": "LOSSLESS",
"audioModes": [
"STEREO"
],
"artist": {
"id": 3529689,
"name": "The Notwist",
"type": "MAIN"
},
"artists": [
{
"id": 3529689,
"name": "The Notwist",
"type": "MAIN"
}
],
"album": {
"id": 82448449,
"title": "Neon Golden",
"cover": "ad3ed5f3-37a2-4b27-9002-b83459ab5a0e",
"videoCover": null
},
"mixes": {
"TRACK_MIX": "001981d70c53d5448599714c407079"
}
}
]
}
HIFI returns the following status codes in its API:
Status Code Description 200 OK422 UNPROCESSABLE CONTENT404 NOT FOUND500 INTERNAL SERVER ERROR
GET /cover/
Parameter Type Description idinteger Track Id = 328060990qstring Song Name = Maestro
Sizes =
1280px | 640px | 80px
HTTPie
https GET "https://tidal.401658.xyz/cover/?q=Maestro"
https GET "https://tidal.401658.xyz/cover/?id=328060990"
[
{
"1280": "https://resources.tidal.com/images/6f5c52be/c21c/4fb7/9ce6/0c270f6f1a5a/1280x1280.jpg",
"640": "https://resources.tidal.com/images/6f5c52be/c21c/4fb7/9ce6/0c270f6f1a5a/640x640.jpg",
"80": "https://resources.tidal.com/images/6f5c52be/c21c/4fb7/9ce6/0c270f6f1a5a/80x80.jpg",
"id": 328060988,
"name": "Maestro: Music by Leonard Bernstein (Original Soundtrack / Dolby Atmos)"
}
]GET /song/
Parameter Type Description qstring Song Query = Minequalitystring Song Quality = HI_RES_LOSSLESSorHI_RESorLOSSLESSorHIGHorLOW
HTTPie
https GET "https://tidal.401658.xyz/song/?q=Mine&quality=HI_RES"
{
"OriginalTrackUrl": "track url",
"Song Info": {
"adSupportedStreamReady": true,
"album": {
"cover": "22b8ce2a-1912-4fc6-956f-3be5eb4a7f4c",
"id": 79712262,
"title": "Mine",
"vibrantColor": "#a7d9fc",
"videoCover": null
},
"allowStreaming": true,
"artist": {
"id": 7384212,
"name": "Bazzi",
"picture": "2726f1e5-0435-4c49-a6f7-c2192544638f",
"type": "MAIN"
},
"artists": [
{
"id": 7384212,
"name": "Bazzi",
"picture": "2726f1e5-0435-4c49-a6f7-c2192544638f",
"type": "MAIN"
}
],
"audioModes": [
"STEREO"
],
"audioQuality": "HI_RES",
"copyright": "2017",
"djReady": true,
"duration": 134,
"editable": false,
"explicit": true,
"id": 79712263,
"isrc": "USAT21704227",
"mediaMetadata": {
"tags": [
"LOSSLESS",
"MQA"
]
},
"mixes": {
"TRACK_MIX": "0014833cd62b1eecd3b24115e5f8d4"
},
"peak": 0.997437,
"popularity": 64,
"premiumStreamingOnly": false,
"replayGain": -10.39,
"stemReady": false,
"streamReady": true,
"streamStartDate": "2017-10-12T00:00:00.000+0000",
"title": "Mine",
"trackNumber": 1,
"url": "http://www.tidal.com/track/79712263",
"version": null,
"volumeNumber": 1
},
"Track Info": {
"albumPeakAmplitude": 0.997437,
"albumReplayGain": -10.39,
"assetPresentation": "FULL",
"audioMode": "STEREO",
"audioQuality": "HI_RES",
"manifest": "base64 manifest",
"manifestMimeType": "application/vnd.tidal.bts",
"trackId": 79712263,
"trackPeakAmplitude": 0.997437,
"trackReplayGain": -10.39
}
}
HIFI returns the following status codes in its API:
Status Code Description 200 OK422 UNPROCESSABLE CONTENT404 NOT FOUND500 INTERNAL SERVER ERROR
GET /album/
Parameter Type Description idinteger Album Id = 157117504
HTTPie
https GET "https://tidal.401658.xyz/album/?id=157117504"
{
"adSupportedStreamReady": true,
"allowStreaming": true,
"artist": {
"id": 7162333,
"name": "Dua Lipa",
"picture": "28047130-6ada-4955-b3b9-65bed4508618",
"type": "MAIN"
},
"artists": [
{
"id": 7162333,
"name": "Dua Lipa",
"picture": "28047130-6ada-4955-b3b9-65bed4508618",
"type": "MAIN"
}
],
"audioModes": [
"SONY_360RA"
],
"audioQuality": "LOW",
"copyright": "℗ 2017 Dua Lipa Limited under exclusive license to Warner Music UK Limited",
"cover": "deae7f19-5da7-4d73-97be-ce901911c939",
"djReady": true,
"duration": 2456,
"explicit": false,
"id": 157117504,
"mediaMetadata": {
"tags": [
"SONY_360RA"
]
},
"numberOfTracks": 12,
"numberOfVideos": 0,
"numberOfVolumes": 1,
"popularity": 36,
"premiumStreamingOnly": false,
"releaseDate": "2020-10-05",
"stemReady": false,
"streamReady": true,
"streamStartDate": "2020-10-05T00:00:00.000+0000",
"title": "Dua Lipa (360 Reality Audio)",
"type": "ALBUM",
"upc": "190295160180",
"url": "http://www.tidal.com/album/157117504",
"version": null,
"vibrantColor": "#6d99c6",
"videoCover": null
}HIFI returns the following status codes in its API:
Status Code Description 200 OK422 UNPROCESSABLE CONTENT404 NOT FOUND500 INTERNAL SERVER ERROR
GET /playlist/
Parameter Type Description idstring Playlist UUID = 910c525f-be8a-41a1-b557-2682af2bcef3
HTTPie
https GET "https://tidal.401658.xyz/playlist/?id=910c525f-be8a-41a1-b557-2682af2bcef3"
{
"created": "2015-04-14T16:32:14.636+0000",
"creator": {
"id": 5034071,
"name": "VIC MENSA",
"picture": "cdd212a2-dadc-466d-9703-7216a9f66da1",
"type": null
},
"description": "",
"duration": 2696,
"image": "c41cfe9b-cda1-4364-b517-f6a706741d24",
"lastItemAddedAt": null,
"lastUpdated": "2020-03-24T12:27:23.941+0000",
"numberOfTracks": 11,
"numberOfVideos": 0,
"popularity": 0,
"promotedArtists": [
{
"id": 5034071,
"name": "VIC MENSA",
"picture": null,
"type": "MAIN"
},
{
"id": 25022,
"name": "Kanye West",
"picture": null,
"type": "MAIN"
},
{
"id": 3899583,
"name": "Theophilus London",
"picture": null,
"type": "MAIN"
},
{
"id": 5637986,
"name": "Allan Kingdom",
"picture": null,
"type": "MAIN"
}
],
"publicPlaylist": false,
"squareImage": "03750282-401b-481c-bf60-55d6ee9fcc27",
"title": "My Playlist",
"type": "ARTIST",
"url": "http://www.tidal.com/playlist/910c525f-be8a-41a1-b557-2682af2bcef3",
"uuid": "910c525f-be8a-41a1-b557-2682af2bcef3"
},
{
"items": [
{
"cut": null,
"item": {
"adSupportedStreamReady": true,
"album": {
"cover": "43929b37-df27-4e1a-81b2-70692c058674",
"id": 44590541,
"releaseDate": "2015-04-16",
"title": "U Mad",
"vibrantColor": "#FFFFFF",
"videoCover": null
},
"allowStreaming": true,
"artist": {
"id": 5034071,
"name": "VIC MENSA",
"picture": "cdd212a2-dadc-466d-9703-7216a9f66da1",
"type": "MAIN"
},
"artists": [
{
"id": 5034071,
"name": "VIC MENSA",
"picture": "cdd212a2-dadc-466d-9703-7216a9f66da1",
"type": "MAIN"
},
{
"id": 25022,
"name": "Kanye West",
"picture": "26076dbd-7361-40d3-9335-f944d2c49ea6",
"type": "FEATURED"
}
],
"audioModes": [
"STEREO"
],
"audioQuality": "LOSSLESS",
"copyright": "(C) 2015 Roc Nation Records, LLC",
"dateAdded": "2015-04-15T15:03:19.696+0000",
"description": null,
"djReady": true,
"duration": 300,
"editable": false,
"explicit": true,
"id": 44590542,
"index": 0,
"isrc": "QMJMT1500671",
"itemUuid": "90545040-acc7-44c1-9481-7e48f36cefe8",
"mediaMetadata": {
"tags": [
"LOSSLESS"
]
},
"mixes": {
"TRACK_MIX": "00169d5b613bbc32050146c8be21df"
},
"peak": 0.999359,
"popularity": 47,
"premiumStreamingOnly": false,
"replayGain": -9.38,
"stemReady": false,
"streamReady": true,
"streamStartDate": "2015-04-10T00:00:00.000+0000",
"title": "U Mad",
"trackNumber": 1,
"url": "http://www.tidal.com/track/44590542",
"version": null,
"volumeNumber": 1
},
"type": "track"
},HIFI returns the following status codes in its API:
Status Code Description 200 OK422 UNPROCESSABLE CONTENT404 NOT FOUND500 INTERNAL SERVER ERROR
GET /artist/
Parameter Type Description idinteger Artist ID = 5034071finteger Artist ID = 5034071, This will retrieve all the albums and tracks.
HTTPie
https GET "https://tidal.401658.xyz/artist/?id=5034071"
[
{
"artistRoles": [
{
"category": "Artist",
"categoryId": -1
},
{
"category": "Songwriter",
"categoryId": 2
},
{
"category": "Production team",
"categoryId": 10
},
{
"category": "Producer",
"categoryId": 1
},
{
"category": "Engineer",
"categoryId": 3
},
{
"category": "Performer",
"categoryId": 11
}
],
"artistTypes": [
"ARTIST",
"CONTRIBUTOR"
],
"id": 5034071,
"mixes": {
"ARTIST_MIX": "000720bd7d7867c71a4c63b1fe61cf"
},
"name": "VIC MENSA",
"picture": "cdd212a2-dadc-466d-9703-7216a9f66da1",
"popularity": 66,
"url": "http://www.tidal.com/artist/5034071"
},
[
{
"750": "https://resources.tidal.com/images/cdd212a2/dadc/466d/9703/7216a9f66da1/750x750.jpg",
"id": 5034071,
"name": "VIC MENSA"
}
]
]
HIFI returns the following status codes in its API:
Status Code Description 200 OK422 UNPROCESSABLE CONTENT404 NOT FOUND500 INTERNAL SERVER ERROR
GET /lyrics/
Parameter Type Description idinteger Track ID = 286266926
HTTPie
https GET "https://tidal.401658.xyz/lyrics/?id=286266926"
[
{
"isRightToLeft": false,
"lyrics": "You know I question every motive, everything you saynThought with you, maybe my heart wasn't meant to breaknCan't believe I let you in, I can't believe I stayednAs long as I stayed, yeahnnI hope one day someone will take your heart and hold it tightnMake you feel like you're invincible deep insidenAnd right when you think that it's perfect, they cross a linenAnd steal your shinenLike you did minennGo ahead and break my heart, that's finenSo unkindnEternal sunshine of the spotless mindnOh, love is blindnWhy am I missin' you tonight?nWas it all a lie?nSomeone's gonna show you how a heart can be usednLike you did minennAnd now, I second-guess my thoughts, every step I takenI'm losin' hope in love, and I've lost all in faithnYeah, for a dreamer, I just close my eyes and it's all blanknI have you to thank, yeahnnI hope one day someone will take your heart and hold it tightnMake you feel like you're invincible deep insidenAnd right when you think that you'll try again, they cross a linenAnd steal your shinenLike you did minennGo ahead and break my heart, that's finenSo unkindnEternal sunshine of the spotless mindnOh, love is blindnWhy am I missin' you tonight?nWas it all a lie?nSomeone's gonna show you how a heart can be usednnAnd you keep talkin', it'll come back, karmanIs the truth, I don't make you look bad, you do, darlin'nSabotage, your choice of artnWho the hell do you think you are?nnGo ahead and break my heart, that's finenEternal sunshine of the spotless mindnWhy am I missin' you tonight?nSomeone's gonna show you how a heart can be usednLike you did mine",
"lyricsProvider": "MUSIXMATCH",
"providerCommontrackId": "158550594",
"providerLyricsId": "31545572",
"subtitles": "[00:00.48] You know I question every motive, everything you sayn[00:04.51] Thought with you, maybe my heart wasn't meant to breakn[00:08.57] Can't believe I let you in, I can't believe I stayedn[00:13.40] As long as I stayed, yeahn[00:16.35] I hope one day someone will take your heart and hold it tightn[00:20.64] Make you feel like you're invincible deep insiden[00:24.45] And right when you think that it's perfect, they cross a linen[00:28.97] And steal your shinen[00:30.77] Like you did minen[00:33.04] Go ahead and break my heart, that's finen[00:38.97] So unkindn[00:40.97] Eternal sunshine of the spotless mindn[00:46.48] Oh, love is blindn[00:49.13] Why am I missin' you tonight?n[00:54.53] Was it all a lie?n[00:57.18] Someone's gonna show you how a heart can be usedn[01:02.86] Like you did minen[01:06.11] n[01:08.32] And now, I second-guess my thoughts, every step I taken[01:12.67] I'm losin' hope in love, and I've lost all in faithn[01:16.42] Yeah, for a dreamer, I just close my eyes and it's all blankn[01:21.56] I have you to thank, yeahn[01:24.30] I hope one day someone will take your heart and hold it tightn[01:28.57] Make you feel like you're invincible deep insiden[01:32.43] And right when you think that you'll try again, they cross a linen[01:36.96] And steal your shinen[01:39.06] Like you did minen[01:41.11] Go ahead and break my heart, that's finen[01:47.09] So unkindn[01:49.03] Eternal sunshine of the spotless mindn[01:54.52] Oh, love is blindn[01:57.17] Why am I missin' you tonight?n[02:02.52] Was it all a lie?n[02:04.93] Someone's gonna show you how a heart can be usedn[02:11.65] And you keep talkin', it'll come back, karman[02:17.64] Is the truth, I don't make you look bad, you do, darlin'n[02:23.79] Sabotage, your choice of artn[02:29.90] Who the hell do you think you are?n[02:37.59] Go ahead and break my heart, that's finen[02:44.06] Eternal sunshine of the spotless mindn[02:49.03] n[02:51.56] Why am I missin' you tonight?n[02:56.72] n[02:59.23] Someone's gonna show you how a heart can be usedn[03:05.24] Like you did minen[03:06.49] ",
"trackId": 286266926
}
]
HIFI returns the following status codes in its API:
Status Code Description 200 OK422 UNPROCESSABLE CONTENT404 NOT FOUND500 INTERNAL SERVER ERROR
Please refer to CONTRIBUTING.md.
Please refer to SECURITY.md.
This project is licensed under the terms of the MIT license.
