goblin-malin 0.1.0

package/LICENSE

@@ -0,0 +1,132 @@
+# PolyForm Noncommercial License 1.0.0
+
+<https://polyformproject.org/licenses/noncommercial/1.0.0>
+
+## Acceptance
+
+In order to get any license under these terms, you must agree
+to them as both strict obligations and conditions to all
+your licenses.
+
+## Copyright License
+
+The licensor grants you a copyright license for the
+software to do everything you might do with the software
+that would otherwise infringe the licensor's copyright
+in it for any permitted purpose.  However, you may
+only distribute the software according to the
+Distribution License section below, and you may only
+make changes or new works based on the software according
+to the Changes and New Works License section below.
+
+## Distribution License
+
+The licensor grants you an additional copyright license
+to distribute copies of the software.  Your license
+to distribute covers distributing the software with
+changes and new works permitted by the
+Changes and New Works License section below.
+
+## Notices
+
+You must ensure that anyone who gets a copy of
+any part of the software from you also gets a copy
+of these terms or the URL for them above, as well as
+copies of any plain-text lines beginning with `Required Notice:`
+that the licensor provided with the software.  For example:
+
+> Required Notice: Copyright Yoyodyne, Inc. (http://example.com)
+
+## Changes and New Works License
+
+The licensor grants you an additional copyright license to
+make changes and new works based on the software for
+any permitted purpose.
+
+## Patent License
+
+The licensor grants you a patent license for the software that
+covers patent claims the licensor can license, or becomes able
+to license, that you would infringe by using the software.
+
+## Noncommercial Purposes
+
+Any noncommercial purpose is a permitted purpose.
+
+## Personal Uses
+
+Personal use for research, experiment, and testing for
+the benefit of public knowledge, personal study,
+private entertainment, hobby projects, amateur pursuits,
+or religious observance, without any anticipated
+commercial application, is use for a noncommercial purpose.
+
+## Noncommercial Organizations
+
+Use by any charitable organization, educational institution,
+public research organization, public safety or health
+organization, environmental protection organization,
+or government institution is use for a noncommercial
+purpose regardless of the source of funding or obligations
+resulting from the funding.
+
+## Fair Use
+
+You may have "fair use" rights for the software under the
+law. These terms do not limit them.
+
+## No Other Rights
+
+These terms do not allow you to sublicense or transfer
+any of your licenses to anyone else, or prevent the
+licensor from granting licenses to anyone else.  These
+terms do not imply any other licenses.
+
+## Patent Defense
+
+If you make any written claim that the software infringes
+or contributes to infringement of any patent, your patent
+license for the software granted under these terms ends
+immediately.  If your company makes such a claim, your
+patent license ends immediately for work on behalf of
+your company.
+
+## Violations
+
+The first time you are notified in writing that you have
+violated any of these terms, or done anything with the
+software not covered by your licenses, your licenses
+can nonetheless continue if you come into full compliance
+with these terms, and take practical steps to correct
+past violations, within 32 days of receiving notice.
+Otherwise, all your licenses end immediately.
+
+## No Liability
+
+*As far as the law allows, the software comes as is,
+without any warranty or condition, and the licensor
+will not be liable to you for any damages arising out
+of these terms or the use or nature of the software,
+under any kind of legal claim.*
+
+## Definitions
+
+The **licensor** is the individual or entity offering
+these terms, and the **software** is the software the
+licensor makes available under these terms.
+
+**You** refers to the individual or entity agreeing
+to these terms.
+
+**Your company** is any legal entity, sole proprietorship,
+or other kind of organization that you work for, plus all
+organizations that have control over, are under the control of,
+or are under common control with that organization.  **Control**
+means ownership of substantially all the assets of an entity,
+or the power to direct its management and legal affairs.
+
+**Your licenses** are all the licenses granted to you for the
+software under these terms.
+
+**Use** means anything you do with the software requiring
+one of your licenses.

package/README.md

@@ -0,0 +1,31 @@
+# goblin-malin 😉
+
+> [!CAUTION]
+> **This project is in early, early, early development.**<br>
+> 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
+
+No easy installation yet. You can only run the project as developer:
+
+1. Clone the repository and open a terminal in the project directory
+2. Install [Node.js](https://nodejs.org/en/download) and [yarn](https://classic.yarnpkg.com/lang/en/docs/install)
+3. Install dependencies in the project directory: `yarn install`
+4. Run the application: `yarn run dev`
+
+## Steps
+
+- Import track URLs from compatible streaming platforms with `Ctrl+V`:
+  - Spotify
+  - 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
+
+<img src="docs\screenshots\2026-05-08-download-view.png" width="100%"/>