Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/koniziwa/orion

CLI application that can be used to download music and automatically set metadata to it
https://github.com/koniziwa/orion

cli genius itunes javascript metadata music nodejs youtube

Last synced: 3 days ago
JSON representation

CLI application that can be used to download music and automatically set metadata to it

Host: GitHub
URL: https://github.com/koniziwa/orion
Owner: koniziwa
License: mit
Created: 2024-05-14T13:05:24.000Z (6 months ago)
Default Branch: master
Last Pushed: 2024-06-26T08:55:47.000Z (5 months ago)
Last Synced: 2024-06-26T10:24:48.839Z (5 months ago)
Topics: cli, genius, itunes, javascript, metadata, music, nodejs, youtube
Language: JavaScript
Homepage:
Size: 1.09 MB
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

🌚 ORION

a CLI tool for easy downloading songs & metadata (for example, you can use it with iTunes to make beautiful music library like I do)

## 🍒 Preview

![preview-select-song](./assets/images/preview-select-song.png)
![preview-folder](./assets/images/preview-folder.png)
![preview-song](./assets/images/preview-song.png)

## ⚡️ Installation

### 💥 Dependencies

Make sure you have installed and added to $PATH

- FFmpeg (https://ffmpeg.org/)
- Node.js (https://nodejs.org/en)
- Git (optional, https://git-scm.com/)

### 🫧 Cloning application

You can download zip archive containing all source code from GitHub **OR** use

```shell
cd directory-you-want
git clone https://github.com/koniziwa/orion.git
```

### ☃️ Getting packages

As a next step, we are going to install yarn (because i love it, but you can use any package manager you want)

```shell
npm install -g yarn
```

Then you should move to **Orion** directory (folder)

```shell
cd directory-from-previous-step/orion
```

Finally, install all required packages using just one word

```shell
yarn
```

### 🌴 Setting API keys

To use the application, you must get API keys and bind them

- [ Genius ] Go to https://genius.com/api-clients, get into account, then click **Generate Access Token**, save it

![genius-api](./assets/images/genius-api.png)

- [ YouTube ] Go to https://console.cloud.google.com/apis/, get into account, create sample project, find and enable **YouTube Data API v3**, forward to **Credentials**, create **API key** using **Create credentials**, save API

![youtube-api](./assets/images/youtube-api.png)
![youtube-credentials](./assets/images/youtube-credentials.png)

We want to bind API to our application, let's do it

```shell
cd folder-where-you-have-orion/orion
node ./setAPI.js
```

Simply paste tokens you have

### ⭐️ Congratulations!

Now you have installed **Orion** on your device, just try it

```shell
node ./index.js
```