Skip to content

Releases: Dniel97/RedSea

RedSea v3.1.0 released

29 Aug 22:39
@Dniel97 Dniel97
v3.1.0
7fe65ff
Compare
Choose a tag to compare
RedSea v3.1.0 released Latest
Latest

Installing

After every release (or after the message ModuleNotFoundError: No module named 'xyz') I recommend to install/update the requirements.txt using pip install -r requirements.txtto install/update the needed packages.

Searching

With a simple command: python redsea.py search [track/album/video] [name of song/video, spaces are allowed] you can search a track/album or a video with a given name. So for example python redsea.py search track Señorita Shawn Mendes searches for a track with the name Shawn Mendes Señorita. It will list all the tracks and the according quality (Dolby Atmos, Sony 360, MQA) and an explicit tag (E):

1) Señorita - Shawn Mendes
2) Señorita - Shawn Mendes [Dolby Atmos]
...
11) Not found? Try a new search

If you haven't found what you're looking for you can always enter 11 and enter a new query, like track Alan Walker Darkside.

Video downloading

RedSea v3.1.0 now supports video downloading! So first you need to install ffmpeg for your platform, read First Setup. So you can provide a video url, f.e. python redsea.py https://tidal.com/browse/video/111726719 and RedSea can automatically download the video in the desired resolution which can be set inside config/settings.py. If you are too lazy to copy the link, you can also use the search function to search for a video using ´python redsea.py search video Shawn Mendes Señorita. The default value inside settings.example.pyis"resolution": 1080which means 1080p. Other possible values are:720, 480and360`.

ID downloading

The new RedSea version also supports id downloading, so instead of providing the complete URL you can simply pass the id with python redsea.py id 111726719. It doesn't (yet) support ids inside a .txt file, which could be provided using the -f parameter.

Exploring

Always wanted to know which albums are getting a Dolby Atmos or 360 Reality audio release? With python redsea.py explore (dolby atmos/sony 360) you can do just that. For example: python redsea.py explore dolby atmos is returning a list with the 50 newest Dolby Atmos albums available on Tidal:

1) B4 The Storm - Internet Money [E] [Dolby Atmos] (2020-08-28)
2) All Rise - Gregory Porter [Dolby Atmos] (2020-08-28)
...

Lyrics

This new version supports retrieving synchronized lyrics from the services LyricFind via Deezer, and Musixmatch, automatically falling back if one doesn't have lyrics, depending on the configuration, inside the config/settings.py you can enable/disable the lyrics download with "lyrics": True/False, and set the preferred lyrics provider "lyrics_provider_order": ["Deezer", "musiXmatch"],. You can only set it to Musixmatch (or Deezer) with "lyrics_provider_order": ["musiXmatch"],.

Presets

Inside the config/settings.py file are several presets with the same options each. The newly added options in this release are lyrics_provider_order, artwork_size and resolution.

  • lyrics_provider_order: Defines the order (from left to right) you want to get the lyrics from, default is ["Deezer", "musiXmatch"]
  • artwork_size: Downloads (artwork_size)x(artwork_size) album covers from iTunes, default is 3000
  • resolution: Which resolution you want to download the videos, default is 1080

New format variables are available:

The new format variables are {title}, {artist}, {album}, {tracknumber}, {discnumber}, {date}, {quality}, {explicit}.

  • {quality} has a whitespace in front, so it will look like this " [Dolby Atmos]", " [360]" or " [M]" according to the downloaded quality
  • {explicit} has a whitespace in front, so it will look like this " [E]"

The new album_format now looks like this: "album_format": "{albumartist} - {album}{quality}{explicit}",

Assets 2
Loading

RedSea v3.0.0 released

30 Jul 23:45
@Dniel97 Dniel97
v3.0.0
6b082ba
Compare
Choose a tag to compare
RedSea v3.0.0 released

RedSea v3.0.0 with a complete Login System and some major quality of life improvements

Installing

After every release (or after the message ModuleNotFoundError: No module named 'xyz') I recommend to install/update the requirements.txt using pip install -r requirements.txtto install/update the needed packages.

Login system

The Login System now features two different login methods:

  1. TV: You recieve a 6 digit key which you should enter on https://link.tidal.com to link your device to your Tidal Account. Keep in mind that you can't download Dolby Atmos AC-4 or Sony 360 Reality Audio. (Thanks to @shahzoorali for helping me)
  2. Mobile: You need to enter your username/email and your password to create a session. Inside the config/settings.py file are two Tokens, the first token labeled MQA can be used for FLAC, MQA and Sony 360 RA, the second token labeled Dolby Atmos AC-4 enables the Dolby Atmos streaming. So if you just want MQA, Sony 360 RA uncomment the MQA token and comment the Dolby AC-4 token.

Run python redsea.py auth add to add a session, you can also create a TV session and a Mobile session using the same account if you want and give both a different [NAME]. With the command python redsea.py -a [NAME] [URL] you can easily select a different already created session.

Presets

Inside the config/settings.py file are several presets with the same options each. The newly added options are convert_to_alac and lyrics.

  • convert_to_alac requires the installation of ffmpeg and converts FLAC files to ALAC for better iTunes integration and UPC/explicit tags.
  • lyrics requires lyricsgenius and enables embedding the lyrics from GENIUS in .flac and .m4a. Keep in mind that enabling this option slows down the tagging process.

Tagging changes

When convert_to_alac is set to True the explicit and UPC tags from Tidal are written inside the ALAC files. (Flac don't support these tags). Now RedSea supports Track name, Album, Artist, Recorded date, Volumes, Track position, Cover, ISRC, Copyright, Lyrics (if enabled). Everything else should be identical between FLAC and ALAC. There are some bugs: if an album is using multiple volumes the total tracks aren't working correctly.

File support

Now RedSea supports .txt files with a link every line. So instead of pasting 400 links in one command line you can now enter all the links to a [FILE].txt file, where every line has only a single link (album/artist/track link). The file can then be executed with python redsea.py -f [FILE].txt or python redsea.py --file [FILE].txt.

Region-locked

Sometimes a song or album is region-locked, then just change the COUNTRYCODE inside config/settings.py to the specific country where the song or alum could be streamed.

failed_tracks.txt

When some links won't work at all or there is some exception the links are added to the failed_tracks.txt. Where I can take a look at them and see why they won't work.

Assets 2
Loading