freyr-js

_{Hey there, you might want to consider a cleaner and straight-forward installation method, without having to manually setup the requirements. If so, checkout the Docker installation method}

# install node with this nvm command
# freyr works with a minimum of v16
$ nvm install --lts

Please note that YouTube Music must be available in your region for freyr to successfully work, this is because freyr sources raw audio from YouTube Music.

    ____
   / __/_______  __  _______
  / /_/ ___/ _ \/ / / / ___/
 / __/ /  /  __/ /_/ / /
/_/ /_/   \___/\__, /_/
              /____/ v0.10.3

freyr - (c) Miraculous Owonubi <[email protected]>
------------------------------------------------------
Usage: freyr get [options] [query...]

Download music tracks from queries

Options:
  -i, --input <FILE>           use URIs found in the specified FILE as queries (file size limit: 1 MiB)
                               (each query on a new line, use '#' for comments, whitespaces ignored)
                               (example: `-i queue.txt`)
  -b, --bitrate <N>            set audio quality / bitrate for audio encoding
                               (valid: 96,128,160,192,256,320) (default: "320k")
  -n, --chunks <N>             number of concurrent chunk streams with which to download (default: 7)
  -r, --retries <N>            set number of retries for each chunk before giving up
                               (`infinite` for infinite) (default: 10)
  -t, --meta-retries <N>       set number of retries for collating track feeds (`infinite` for infinite) (default: 5)
  -d, --directory <DIR>        save tracks to DIR/..
  -D, --check-dir <DIR>        check if tracks already exist in another DIR (repeatable, optionally comma-separated)
                               (useful if you maintain multiple libraries)
                               (example: `-D dir1 -D dir2 -D dir3,dir4`)
  -c, --cover <NAME>           custom name for the cover art, excluding the extension (default: "cover")
  --cover-size <SIZE>          preferred cover art dimensions
                               (format: <width>x<height> or <size> as <size>x<size>) (default: "640x640")
  -C, --no-cover               skip saving a cover art
  -S, --sources <SERVICE>      specify a preferred audio source or a `,`-separated preference order
                               (valid: youtube,yt_music) (prefix with `!` to exclude) (default: "yt_music")
  -l, --filter <MATCH>         filter matches off patterns (repeatable and optionally `,`-separated)
                               (value omission implies `true` if applicable)
                               (format: <key=value>) (example: title="when we all fall asleep*",type=album)
                               See `freyr help filter` for more information
  -L, --filter-case            enable case sensitivity for glob matches on the filters
  -z, --concurrency <SPEC>     key-value concurrency pairs (repeatable and optionally `,`-separated)
                               (format: <[key=]value>) (key omission implies track concurrency)
                               (valid(key): queries,tracks,trackStage,downloader,encoder,embedder)
                               (example: `queries=2,downloader=4` processes 2 CLI queries,
                               downloads at most 4 tracks concurrently)
  --gapless                    set the gapless playback flag for all tracks
  -f, --force                  force overwrite of existing files
  -o, --config <FILE>          specify alternative configuration file
  -p, --playlist <FILENAME>    create playlist for all successfully collated tracks
  -P, --no-playlist            skip creating a playlist file for collections
  --playlist-dir <DIR>         directory to save playlist file to, if any, (default: tracks base directory)
  --playlist-noappend          do not append to the playlist file, if any exists
  --playlist-noescape          do not escape invalid characters within playlist entries
  --playlist-namespace <SPEC>  namespace to prefix on each track entry, relative to tracks base directory
                               useful for, but not limited to custom (file:// or http://) entries
                               (example, you can prefix with a HTTP domain path: `http://webpage.com/music`)
  --playlist-force-append      force append collection tracks to the playlist file
  -s, --storefront <COUNTRY>   country storefront code (example: us,uk,ru)
  -T, --no-tree                don't organise tracks in directory structure `[DIR/]<ARTIST>/<ALBUM>/<TRACK>`
  --cache-dir <DIR>            specify alternative cache directory
                               `<tmp>` for tempdir, `<cache>` for system cache
  --rm-cache [RM]              remove original downloaded files in cache directory (default: false)
  -m, --mem-cache <SIZE>       max size of bytes to be cached in-memory for each download chunk
  --no-mem-cache               disable in-memory chunk caching (restricts to sequential download)
  --timeout <N>                network inactivity timeout (ms) (default: 10000)
  --no-auth                    skip authentication procedure
  --no-browser                 disable auto-launching of user browser
  --no-net-check               disable internet connection check
  --no-bar                     disable the progress bar
  --atomic-parsley <PATH>      explicit path to the atomic-parsley binary
  --no-stats              

提示：代码过长已自动截断

    ____
   / __/_______  __  _______
  / /_/ ___/ _ \/ / / / ___/
 / __/ /  /  __/ /_/ / /
/_/ /_/   \___/\__, /_/
              /____/ v0.10.3

freyr - (c) Miraculous Owonubi <[email protected]>
-------------------------------------------------------------
Checking directory permissions...[done]
[spotify:track:5FNS5Vj69AhRGJWjhrAd01]
 [•] Identifying service...[Spotify]
 [•] Checking authentication...[unauthenticated]
 [Spotify Login]
  [•] Logging in...[done]
 Detected [track]
 Obtaining track metadata...[done]
  ➤ Title: Slow Dance
  ➤ Album: Slow Dance
  ➤ Artist: AJ Mitchell
  ➤ Year: 2019
  ➤ Playtime: 02:58
 [•] Collating...
 • [01 Slow Dance]
    | ➤ Collating sources...
    |  ➤ [•] YouTube Music...[success, found 1 source]
    | ➤ Awaiting audiofeeds...[done]
    | [✓] Got album art
    | [✓] Got raw track file
    | [•] Post Processing...
 [•] Download Complete
 [•] Embedding Metadata...
  • [✓] 01 Slow Dance
[•] Collation Complete
============ Stats ============
 [•] Runtime: [31.7s]
 [•] Total queries: [01]
 [•] Total tracks: [01]
     » Skipped: [00]
     ✓ Passed:  [01]
     ✕ Failed:  [00]
 [•] Output directory: [.]
 [•] Cover Art: cover.png (640x640)
 [•] Total Output size: 7.30 MB
 [•] Total Network Usage: 3.12 MB
     ♫ Media: 3.02 MB
     ➤ Album Art: 106.76 KB
 [•] Output bitrate: 320k
===============================

    ____
   / __/_______  __  _______
  / /_/ ___/ _ \/ / / / ___/
 / __/ /  /  __/ /_/ / /
/_/ /_/   \___/\__, /_/
              /____/ v0.10.3

freyr - (c) Miraculous Owonubi <[email protected]>
-------------------------------------------------------------
Checking directory permissions...[done]
[https://music.apple.com/us/album/im-sorry-im-not-sorry-ep/1491795443]
 [•] Identifying service...[Apple Music]
 [•] Checking authentication...[authenticated]
 Detected [album]
 Obtaining album metadata...[done]
  ➤ Album Name: I'm Sorry, I'm Not Sorry
  ➤ Artist: Sody
  ➤ Tracks: 4
  ➤ Type: Album
  ➤ Year: 2020
  ➤ Genres: Singer/Songwriter, Music
 [•] Collating [I'm Sorry, I'm Not Sorry]...
  [•] Inquiring tracks...[done]
   • [01 What We Had]
      | ➤ Collating sources...
      |  ➤ [•] YouTube Music...[success, found 4 sources]
      | ➤ Awaiting audiofeeds...[done]
      | [✓] Got album art
      | [✓] Got raw track file
      | [•] Post Processing...
   • [02 Reason To Stay]
      | ➤ Collating sources...
      |  ➤ [•] YouTube Music...[success, found 6 sources]
      | ➤ Awaiting audiofeeds...[done]
      | [✓] Got album art
      | [✓] Got raw track file
      | [•] Post Processing...
   • [03 Nothing Ever Changes]
      | ➤ Collating sources...
      |  ➤ [•] YouTube Music...[success, found 4 sources]
      | ➤ Awaiting audiofeeds...[done]
      | [✓] Got album art
      | [✓] Got raw track file
      | [•] Post Processing...
   • [04 Love's a Waste]
      | ➤ Collating sources...
      |  ➤ [•] YouTube Music...[success, found 4 sources]
      | ➤ Awaiting audiofeeds...[done]
      | [✓] Got album art
      | [✓] Got raw track file
      | [•] Post Processing...
 [•] Download Complete
 [•] Embedding Metadata...
  • [✓] 01 What We Had
  • [✓] 02 Reason To Stay
  • [✓] 03 Nothing Ever Changes
  • [✓] 04 Love's a Waste
[•] Collation Complete
============ Stats ============
 [•] Runtime: [2m 2.3s]
 [•] Total queries: [01]
 [•] Total tracks: [04]
     » Skipped: [00]
     ✓ Passed:  [04]
     ✕ Failed:  [00]
 [•] Output directory: [.]
 [•] Cover Art: cover.png (640x640)
 [•] Total Output size: 29.79 MB
 [•] Total Network Usage: 13.35 MB
     ♫ Media: 12.73 MB
     ➤ Album Art: 619.43 KB
 [•] Output bitrate: 320k
===============================

    ____
   / __/_______  __  _______
  / /_/ ___/ _ \/ / / / ___/
 / __/ /  /  __/ /_/ / /
/_/ /_/   \___/\__, /_/
              /____/ v0.10.3

freyr - (c) Miraculous Owonubi <[email protected]>
-------------------------------------------------------------
Checking directory permissions...[done]
[https://www.deezer.com/us/artist/14808825]
 [•] Identifying service...[Deezer]
 [•] Checking authentication...[authenticated]
 Detected [artist]
 Obtaining artist metadata...[done]
  ➤ Artist: Mazie
  ➤ Followers: 6
  > Gathering collections...[done]
 [•] Collating...
  (01) [i think i wanna be alone] (single)
   [•] Inquiring tracks...[done]
    • [01 i think i wanna be alone]
       | ➤ Collating sources...
       |  ➤ [•] YouTube Music...[success, found 2 sources]
       | ➤ Awaiting audiofeeds...[done]
       | [✓] Got album art
       | [✓] Got raw track file
       | [•] Post Processing...
  (02) [no friends] (single)
   [•] Inquiring tracks...[done]
    • [01 no friends]
       | ➤ Collating sources...
       |  ➤ [•] YouTube Music...[success, found 4 sources]
       | ➤ Awaiting audiofeeds...[done]
       | [✓] Got album art
       | [✓] Got raw track file
       | [•] Post Processing...
 [•] Download Complete
 [•] Embedding Metadata...
  • [✓] 01 i think i wanna be alone
  • [✓] 01 no friends
[•] Collation Complete
============ Stats ============
 [•] Runtime: [54.6s]
 [•] Total queries: [01]
 [•] Total tracks: [02]
     » Skipped: [00]
     ✓ Passed:  [02]
     ✕ Failed:  [00]
 [•] Output directory: [.]
 [•] Cover Art: cover.png (640x640)
 [•] Total Output size: 8.47 MB
 [•] Total Network Usage: 3.66 MB
     ♫ Media: 3.50 MB
     ➤ Album Art: 157.16 KB
 [•] Output bitrate: 320k
===============================

spotify:album:2D23kwwoy2JpZVuJwzE42B
[+] Urify complete

[+] Urify complete
Successfully written to [queue_of_uris.txt]

Persistent configuration such as authentication keys and their validity period are stored within a session specific configuration file.

This configuration file resides within the user config directory per-platform.

• $HOME/.config/FreyrCLI/d3fault.x4p for Linux.
• $HOME/Library/Preferences/FreyrCLI/d3fault.x4p for macOS.

All defaults are defined in the conf.json file at the root of the project. This file should be of JSON format and is to be structured as such.

Do not edit this file directly, instead run freyr once and edit the user specific configuration (see above).

• server: <object> The server URL configuration same as on an individual services’ callback option.
  • hostname: <string>
  • port: <number>
  • useHttps: <boolean>
• concurrency: <object>
  • queries: <number> The number of queries to be processed concurrently.
  • tracks: <number> The number of tracks to be actively processed in parallel.
  • trackStage: <number> The number of tracks to concurrently preprocess before being pushed to the main trackQueue.
  • downloader: <number> The number of tracks to be concurrently downloaded in parallel.
  • encoder: <number> The total number of tracks to be concurrently undergo encoding.
  • embedder: <number> The total number of tracks to be concurrently embedded in parallel.
• opts: <object>
  • netCheck: <boolean> Whether or not to check network access at program start.
  • attemptAuth: <boolean> Whether or not to process authentication.
  • autoOpenBrowser: <boolean> Whether or not to automatically open user browser.
• filters: <FilterRules[]> Filter rules each track must match to be downloaded.
• dirs: <object>
  • output: <string> Default download directory. Default: "."
  • check: <string[]> List of directories to check for existing files. Default: ["."]
  • cache: <object>
    • path: <string> Path to download pre-processed audio to ("<tmp>" for tempdir, "<cache>" for system cache). Default: "<cache>"
    • keep: <string> Whether or not to keep the pre-processed audio. Default: "true"
• playlist: <object>
  • always: <boolean> Always create playlists for collections and non-collections alike.
  • append: <boolean> Append non-collection tracks onto the playlist file.
  • escape: <boolean> Escape # characters within playlist entries paths.
  • forceAppend: <boolean> Force append collection tracks.
  • dir: <string> Default playlist save directory.
  • namespace: <string> Prefix namespace to prepend to track paths.
• image: <object|number|string> An object with fields pertaining to an image’s properties or a number defining its size. (<width>x<height> or <size> as <size>x<size>)
  • width: <number|string>
  • height: <number|string>
• downloader: <object>
  • memCache: <boolean> Whether or not to use in-memory caching for download chunks.
  • cacheSize: <number> Maximum size of bytes to be cached per download.
  • sources: <array> Service download sources order.
    • Freyr would check these download sources in the order which they are defined. Failure to get a query from a source would try the next available source. You can exclude a source by prefixing it with a ! character.
    • supported: youtube, yt_music
    • default: [ "yt_music", "youtube" ]
• services: <ServiceConfiguration: object>

{
  "server": {
    "hostname": "localhost",
    "port": 36346,
    "useHttps": false
  },
  "image": {
    "width": 640,
    "height": 640
  },
  "services": {
    "spotify": {
      "clientId": "CLIENT_ID",
      "clientSecret": "CLIENT_SECRET",
      "refreshToken": "OPTIONAL_REFRESH_TOKEN"
    },
    "apple_music": {
      "storefront": "us"
    },
    "deezer": {
      "retries": 5
    }
  }
}

• spotify: <object>
  • clientId: <string>
  • clientSecret: <string>
  • refreshToken: <string>

Spotify requires a clientId and a clientSecret that can be gotten from their developer dashboard.

If you wish to create and use custom keys, [See Spotify API Authorization].

An optional refreshToken option can be defined which can be used to authenticate a session without necessarily requesting explicit permissions. The refreshToken is already bound to a pre-authenticated account.

An invalid refreshToken, when specified, would fallback to requesting account access which in-turn would request re-authentication of the users’ account.

Spotify API Authorization

1. Sign in to the Spotify Dashboard
2. Click CREATE A CLIENT ID and create an app
3. Now click Edit Settings
4. Add http://localhost:36346/callback to the Redirect URIs
5. Include the clientId and the clientSecret from the dashboard in the spotify object that is a property of the services object of the conf.json file. [See Configuration]
6. You are now ready to authenticate with Spotify!

• apple_music: <object>
  • storefront: <string>
  • developerToken: <string>

Freyr would automatically fetch a developer token from the Apple Music site, which should suffice for all intents and purposes. But if you prefer to use a custom developer token, please refer to the Apple Music documentation on this topic.

The storefront option defines the default storefront to be used in the absence of a specification.

Apple Music API Authorization

[See Apple Music API: Getting Keys and Creating Tokens]

After successfully acquiring the developer token, include the developerToken to the apple_music object that’s a property of the services object in the conf.json file. [See Configuration]

An expired developer token in the conf.json would make freyr fallback to fetching it from the Apple Music site.

• deezer: <object>
  • retries: <number>

Authentication unrequired. API is freely accessible.

Because of the 50 requests / 5 seconds limit enforced on an IP-basis for Deezer’s API [See #32], occasionally a Quota limit exceeded error would be thrown by the API server.

To combat this, freyr employs request batching, managed delays and finally, retries when things go awry.

You can configure how many retries you want freyr to make before accepting failure.

[
  {
    "query": "*",
    "filters": {
      "title": "all*good girls*hell",
      "artist": "*eilish",
      "trackn": "4..=5"
    }
  }
]