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}",