Built with ❤︎ by Miraculous Owonubi
-
Via Coinbase (
BTC,ETH,USDC,LTC,DAI,BCH):- Support us with
$5|$10|$15|$20 - Donate anything you want
- Support us with
-
Or Directly:
:
bc1qqe5y9kw7ewne8njdces8e4ajx5u7zhfftdvl33:
GB6GPPXXJTQ6EFYQQ4PFA4WEAT5G2DIDILOEDLYH76743UUVDDU4KOWY:
zs10awcwm4uwpjr3mxxdwe03fda0j0zn95s4hu3qxlvhfajjw8es98ftmpaava7zh735x9s22pan0l
Ensure all requirements are satisfied before installing.
You can use either of these options to install freyr:
-
Install globally via NPM:
npm install -g miraclx/freyr-js
-
Install globally via Yarn:
yarn global add miraclx/freyr-js
-
Or alternatively, you can build from source
git clone https://github.com/miraclx/freyr-js.git freyr-js cd freyr-js-
If using npm:
npm install # to have access to the freyr command globally npm link -
If using yarn:
yarn install # to have access to the freyr command globally yarn link
-
We provide officially prebuilt images (automated builds from this repo).
Pull the image:
docker pull freyrcli/freyrjs| Base Image | Size | Tag |
|---|---|---|
| Alpine (musl) * |  |
freyrcli/freyrjs:latest |
| Arch Linux |  |
freyrcli/freyrjs:archlinux |
*: default
Structure
docker run -it --rm -v $PWD:/data <tag> [options, arguments and queries...]Example, with the freyrcli/freyrjs:latest tag:
docker run -it --rm -v $PWD:/data freyrcli/freyrjs:latestAlternatively, create a handy alias
alias freyr='docker run -it --rm -v $PWD:/data freyrcli/freyrjs:latest'[See Docker Development]
As an alternative to setting up freyr and its dependencies on your host system, consider the Docker installation method for a containerized experience.
python >= v3.2
Download for your individual platforms here https://www.python.org/downloads/
Linux: (check individual package managers)
- * Debian:
sudo apt-get install python3.6 - * Arch Linux:
sudo pacman -S python - Android (Termux):
apt install python - Alpine Linux:
sudo apk add python3 - (
*: should already be preinstalled)
nodejs >= v12.0.0
Download for your individual platforms here https://nodejs.org/en/download/
macOS + Linux: nvm recommended.
# install node with this nvm command
# freyr works with a minimum of v12
$ nvm install --lts- Android (Termux):
apt install nodejs - Alpine Linux:
sudo apk add nodejs
ffmpeg >= v0.9
Download for your individual platforms here https://ffmpeg.org/download.html
- Windows + macOS:
- Ensure to extract the
ffmpegbinary from the compressed file, if it's in one. - make sure it's available in your
PATH - otherwise, set
FFMPEG_PATHto explicitly specify binary to use
- Ensure to extract the
- Linux: (check individual package managers)
- Debian: The
ppa:mc3man/trusty-mediaPPA provides recent builds - Arch Linux:
sudo pacman -S ffmpeg - Android (Termux):
apt install ffmpeg - Alpine Linux:
sudo apk add ffmpeg
- Debian: The
youtube-dl @ latest
- automatically fetched by installing this package
- optionally, you can fetch the source yourself https://github.com/ytdl-org/youtube-dl and include in your
PATH
AtomicParsley >= (v0.9.6 | 20200701)
First, download the latest release for your individual platforms here https://github.com/wez/atomicparsley/releases/latest
Then;
- Windows:
- unzip and place the
AtomicParsley.exein yourPATH. - or the
bins/windowsfolder of this project directory. Create the folder(s) if they don't exist.
- unzip and place the
- Linux + macOS (the brew package isn't recommended):
- unzip and place the
AtomicParsleyin yourPATH. - or the
bins/posixfolder of this project directory. Create the folder(s) if they don't exist.
- unzip and place the
- Alternatively:
- Debian:
sudo apt-get install atomicparsley - Arch Linux:
sudo pacman -S atomicparsley - Android (Termux):
apt install atomicparsley - Build from source: See wez/AtomicParsley
- Debian:
Usage: freyr [options] [query...]
Usage: freyr [options] [subcommand]
[See Service Support].
freyr --help
*The get subcommand is implicit and default.
Usage: freyr [options] get [options] [query...]
Usage: freyr [options] [query...]
freyr get --help
____
/ __/_______ __ _______
/ /_/ ___/ _ \/ / / / ___/
/ __/ / / __/ /_/ / /
/_/ /_/ \___/\__, /_/
/____/ v0.1.0
freyr v0.1.0 - (c) Miraculous Owonubi <omiraculous@gmail.com>
-------------------------------------------------------------
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/..
-c, --cover <NAME> custom name for the cover art (default: "cover.png")
--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
-x, --format <FORMAT> preferred audio output format (to export) (unimplemented)
(valid: mp3,m4a,flac) (default: "m4a")
-D, --downloader <SERVICE> specify a preferred download source or a `,`-separated preference order
(valid: youtube,yt_music) (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>`
--tags tag configuration specification (repeatable and optionally `,`-separated) (unimplemented)
(format: <key=value>) (reserved keys: [exclude, account])
--via-tor tunnel network traffic through the tor network (unimplemented)
--cache-dir <DIR> specify alternative cache directory, `<tmp>` for tempdir
-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
--ffmpeg <PATH> explicit path to the ffmpeg binary
--youtube-dl <PATH> explicit path to the youtube-dl binary
--atomic-parsley <PATH> explicit path to the atomic-parsley binary
--no-stats don't show the stats on completion
--pulsate-bar show a pulsating bar
--single-bar show a single bar for the download, hide chunk-view
(default when number of chunks/segments exceed printable space)
-h, --help show this help information
Environment Variables:
SHOW_DEBUG_STACK show extended debug information
FFMPEG_PATH custom ffmpeg path, alternatively use `--ffmpeg`
YOUTUBE_DL_PATH custom youtube-dl path, alternatively use `--youtube-dl`
ATOMIC_PARSLEY_PATH custom AtomicParsley path, alternatively use `--atomic-parsley`
Info:
When downloading playlists, the tracks are downloaded individually into
their respective folders. However, a m3u8 playlist file is generated in
the base directory with the name of the playlist that lists the tracks freyr spotify:track:5FNS5Vj69AhRGJWjhrAd01
____
/ __/_______ __ _______
/ /_/ ___/ _ \/ / / / ___/
/ __/ / / __/ /_/ / /
/_/ /_/ \___/\__, /_/
/____/ v0.1.0
freyr v0.1.0 - (c) Miraculous Owonubi <omiraculous@gmail.com>
-------------------------------------------------------------
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
=========================== freyr https://music.apple.com/us/album/im-sorry-im-not-sorry-ep/1491795443
____
/ __/_______ __ _______
/ /_/ ___/ _ \/ / / / ___/
/ __/ / / __/ /_/ / /
/_/ /_/ \___/\__, /_/
/____/ v0.1.0
freyr v0.1.0 - (c) Miraculous Owonubi <omiraculous@gmail.com>
-------------------------------------------------------------
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
=========================== freyr https://www.deezer.com/us/artist/14808825
____
/ __/_______ __ _______
/ /_/ ___/ _ \/ / / / ___/
/ __/ / / __/ /_/ / /
/_/ /_/ \___/\__, /_/
/____/ v0.1.0
freyr v0.1.0 - (c) Miraculous Owonubi <omiraculous@gmail.com>
-------------------------------------------------------------
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
===========================Queries can be collated to be processed at once.
freyr query1 query2 ... queryNQueries can be batched into a file and loaded all at once with the -i, --input <FILE> flag.
Queries should be on separate lines.
Lines starting with a # are treated as comments and ignored. comments can also be inlined with everything following the # character ignored.
# ./queue.txt
# Hailee Steinfeld
https://open.spotify.com/track/5Gu0PDLN4YJeW75PpBSg9p # (track) Let Me Go
https://open.spotify.com/track/7GCVboEDzfL3NKp1NrAgHR # (track) Wrong Direction
# (album) Rina Sawayama
https://open.spotify.com/album/3stadz88XVpHcXnVYMHc4J
freyr -i ./queue.txtUse the --help flag to see full usage documentation.
Services can be queried with short URIs containing the type and ID for the resource.
| identifier | type | id | ||
|---|---|---|---|---|
| URI Short Tags | : | track | : | ~ |
| album | ||||
| artist | ||||
| playlist |
Use the urify subcommand to parse betweeen URIs and its equivalent URL representation, and vice-versa.
Creating freyr-compatible queue output.
freyr urify https://open.spotify.com/album/2D23kwwoy2JpZVuJwzE42B --no-header --no-logo --no-tag
spotify:album:2D23kwwoy2JpZVuJwzE42B
[+] Urify complete
freyr urify -i queue_of_urls.txt -o queue_of_uris.txt --no-header --no-logo
[+] Urify complete
Successfully written to [queue_of_uris.txt]
- Multi-service support [See Service Support]
- Playlist generation (per playlist (default) / per query (optional))
- Batch download from queue file
- Simultaneous chunked downloads (powered by [libxget-js])
- Efficient concurrency
- Bitrate specification (valid: 96, 128, 160, 192, 256, 320)
- Album art embedding & export
- Proper track organisation i.e
FOLDER/<Artist Name>/<Album Name>/<Track Name> - Resilient visual progressbar per track download (powered by [xprogress])
- Stats on runtime completion
- runtime duration
- number of successfully processed tracks
- output directory
- cover art name
- total output size
- total network usage
- network usage for media
- network usage for album art
- output bitrate
User / Session specific configuration
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. e.g $HOME/.config/FreyrCLI/d3fault.x4p for Linux.
Project specific configuration
All configuration is to be defined within a conf.json file in the root of the project.
This file should be of JSON format and is to be structured as such.
Defaults are in the conf.json file.
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:"."cache: <string> Default temp download directory. Default:"<tmp>"
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.order: <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.
- supported:
youtube,yt_music - default:
[ "yt_music", "youtube" ]
services: <ServiceConfiguration: object>
Example JSON
{
"server": {
"hostname": "localhost",
"port": 36346,
"useHttps": false
},
"image": {
"width": 640,
"height": 640
},
"services": {
"spotify": {
"client_id": "CLIENT_ID",
"client_secret": "CLIENT_SECRET",
"refresh_token": "OPTIONAL_REFRESH_TOKEN"
},
"apple_music": {
"developerToken": "DEVELOPER_TOKEN"
},
"deezer": {
"retries": 5
}
}
}The conf.json file already includes some API tokens for service authentication and should work right out of the box. [See Project specific configuration]
Spotify
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.
- Sign in to the Spotify Dashboard
- Click
CREATE A CLIENT IDand create an app - Now click
Edit Settings - Add
http://localhost:36346/callbackto the Redirect URIs - Include the
clientIdand theclientSecretfrom the dashboard in thespotifyobject that is a property of theservicesobject of theconf.jsonfile. [See Confiuration] - You are now ready to authenticate with Spotify!
Apple Music
apple_music: <object>storefront: <string>developerToken: <string>
This library already includes a pre-defined developer token that should work at will. This developer token is the default token, extracted off the Apple Music website. While this developer token could expire over time, we'll try to update with the most recent developer token as time goes on.
To create 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.
[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 Confiuration]
Deezer
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.
- 0: OK
- 1: Invalid query
- 2: Invalid flag value
- 3: Invalid / Inexistent configuration file
- 4: Network error
- 5: Error with working directory
- 6: Failed to initialize a freyr instance
- 7: An error occurred checking dependency paths
Filter rules each to be matched against the tracks involved in any operation.
Used as values to the -l, --filter flag or as key-value pairs in the filters array of the configuration file.
| key | syntax | description | examples |
|---|---|---|---|
id |
glob | Resource ID | id=1497949287, id=*149 |
uri |
glob | Resource URI | uri="*:+(track|album):*" |
title |
glob | Track title | title="all*good girls*hell" |
album |
glob | Track album | album="when we*fall*do we go*" |
artist |
glob | Match an artist | artist="Billie*" |
trackn |
Numeric Range | Match a track number range | trackn="2..5", trackn="4..=5" |
type |
Static | album | compilation |
type=compilation |
duration |
Timed Range | Track duration | duration="3s..", duration="2:30..3:00", duration="..=3m" |
explicit |
Static | true | false | inoffensive |
explicit=true, explicit=inoffensive |
album_artist |
glob | Album artist | album_artist="Billie Eilish" |
isrc |
glob | Track ISRC | isrc=USUM71900766 |
label |
glob | Record label | label="*Interscope*" |
year |
Numeric Range | Release year | year=2019, year=2018..2020 |
diskn |
Numeric Range | Disk number | diskn=1 |
ntracks |
Numeric Range | Number of tracks in the album | ntracks=10..=14 |
Syntax: [a][..][[=]b]
| Spec | Match | Representation |
|---|---|---|
.. |
-∞ ... ∞ |
x |
3..7 |
3, 4, 5, 6 |
7 > x ≥ 3 |
3..=7 |
3, 4, 5, 6, 7 |
7 ≥ x ≥ 3 |
..3 |
-∞ ... 0, 1, 2 |
3 > x |
..=3 |
-∞ ... 1, 2, 3 |
3 ≥ x |
5.. |
5, 6, 7 ... ∞ |
x ≥ 5 |
Examples: duration=60s..=3:40
| Metric | Values |
|---|---|
| Seconds | 30, 30s, 00:30 |
| Minutes | 120, 120s, 02:00 |
| Hours | 5400, 5400s, 01:30 |
To preview filter rules specification, use the filter subcommand.
freyr filter title="all*good girls*hell",artist="*eilish",trackn="4..=5" --no-header --no-logo
[
{
"query": "*",
"filters": {
"title": "all*good girls*hell",
"artist": "*eilish",
"trackn": "4..=5"
}
}
]
| Service | Track | Album | Artist | Playlist | URI Short Tags |
|---|---|---|---|---|---|
| Spotify | ✔ | ✔ | ✔ | ✔ | spotify: |
| Apple Music | ✔ | ✔ | ✔ | ✔ | apple_music: |
| Deezer | ✔ | ✔ | ✔ | ✔ | deezer: |
| Youtube Music (See #6) | ✗ | ✗ | ✗ | ✗ | ✗ |
| Tidal (See #33) | ✗ | ✗ | ✗ | ✗ | ✗ |
| Meta | Spotify | Apple Music | Deezer |
|---|---|---|---|
Title |
✔ | ✔ | ✔ |
Artist |
✔ | ✔ | ✔ |
Composer |
✗ | ✔ | ✔ |
Album |
✔ | ✔ | ✔ |
Genre |
✗ | ✔ | ✔ |
Track Number |
✔ | ✔ | ✔ |
Disk Number |
✔ | ✔ | ✔ |
Release Date |
✔ | ✔ | ✔ |
Rating |
✔ | ✔ | ✔ |
Album Artist |
✔ | ✔ | ✔ |
ISRC |
✔ | ✔ | ✔ |
Label |
✔ | ✔ | ✔ |
Copyright |
✔ | ✔ | ✗ |
Cover Art |
✔ | ✔ | ✔ |
Short Service URI Examples
Feel free to clone and use in adherance to the license. Pull requests are very much welcome.
git clone https://github.com/miraclx/freyr-js.git freyr-js
cd freyr-js-
If using NPM:
npm install # to have access to the freyr command globally npm link -
If using Yarn:
yarn install # to have access to the freyr command globally yarn link
To facilitate development and experimentation through Docker, Dockerfiles are provided in the docker/ folder for your convenience.
| Base Image OS | Average Build Network Usage | Average Disk Usage | File |
|---|---|---|---|
| Alpine (musl) | ~ 80 MB | ~ 182 MB | docker/Dockerfile.alpine |
| Arch Linux | ~ 190 MB | ~ 1.2 GB | docker/Dockerfile.archlinux |
# building with default dockerfile (alpine)
git clone https://github.com/miraclx/freyr-js.git freyr
cd freyr
docker build -t freyr-dev:latest .
# alternatively, you can use any other dockerfile
docker build -t freyr-dev:archlinux -f docker/Dockerfile.archlinux .Afterwards, you can drop into the container by explicitly defining the entrypoint
docker run -it --entrypoint bash freyr-dev:latest
# Alternatively, create a handy alias
alias freyrd='docker run -it --entrypoint bash freyr-dev:latest'Optionally, you can use these interesting flags to customize the experience.
-h freyr-devsets the container hostname tofreyr-dev-m 1Gsets the container memory limit-v $PWD:/datamounts the current working directory to/datawithin the container.--cpus 2limits the container to using 2 CPU cores
The freyr source would be available in the /freyr directory within the container along with a globally registered command freyr for calling the script.
For more information and documentation about docker, please refer to its official website:
Apache 2.0 © Miraculous Owonubi (@miraclx) <omiraculous@gmail.com>