goblin-malin 😉

• goblin-malin 😉
  • Installation
    • Installation with npm (RECOMMENDED)
    • Installation with yarn
    • Installation with pnpm
    • Installation on Windows
  • Steps
  • Running the project as a developer
  • Launching the app through js code
  • Screenshots
    • Metadata view
    • Download view

[!CAUTION] This project is in early, early, early development. Be aware that the data model can change drastically, making previous versions incompatible with the current one. Use at your own risk 😉

A keyboard-driven terminal UI for downloading and tagging music tracks with metadata. Import links from Spotify, YouTube, the app cross-references metadata across providers, finds the best download source (only yt-dlp for now), and saves it to disk with clean tags.

Installation

Installation with npm (RECOMMENDED)

1. Install Node.js with npm
2. Install with npm

   npm install -g goblin-malin
   goblin-malin # Run application

Installation with yarn

yarn global add goblin-malin

On windows:

$yarBin = "C:\Users\YOUR_USERNAME\AppData\Local\Yarn\bin"
$current = [System.Environment]::GetEnvironmentVariable("PATH", "User")
[System.Environment]::SetEnvironmentVariable("PATH", "$current;$yarBin", "User")

Installation with pnpm

pnpm add -g  goblin-malin

Installation on Windows

goblin-malin.exe

Steps

• Import with Ctrl+V URLs from compatible streaming platforms :
  • Spotify (requires Spotify Premium Account to have full metadata)
  • YouTube
• System fetches primary metadata from the corresponding URL platform
• System discovers the same track on other platforms (cross-referencing via ISRC or track/artist name)
• Filters/orders metadata sources by relevance or leaves the default ranking chosen by the system (use TAB key to switch the focused window).
• System downloads matching tracks from available download providers:
  • yt-dlp
• User selects the best download source and previews the audio
• User saves the file to the desired folder with embedded tags

Running the project as a developer

You can run the project as a developer:

1. Clone the repository and open a terminal in the project directory
2. Install Node.js and yarn
3. Install dependencies in the project directory: yarn install
4. Run the application: yarn run dev

Launching the app through js code

Not customizable yet

import GoblinMalin from "goblin-malin";

GoblinMalin.start();

Screenshots

Metadata view

Download view