https://github.com/frenzyexists/spotituby
A tool to download music from Spotify and Youtube, free, as it should
https://github.com/frenzyexists/spotituby
cli hobby-project mp3 spotify-cli
Last synced: 7 months ago
JSON representation
A tool to download music from Spotify and Youtube, free, as it should
- Host: GitHub
- URL: https://github.com/frenzyexists/spotituby
- Owner: FrenzyExists
- License: mit
- Created: 2024-02-29T23:43:31.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2025-02-17T08:27:17.000Z (12 months ago)
- Last Synced: 2025-06-26T11:57:37.386Z (8 months ago)
- Topics: cli, hobby-project, mp3, spotify-cli
- Language: JavaScript
- Homepage:
- Size: 959 KB
- Stars: 5
- Watchers: 2
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# 🎵 Spotituby
*Download your favorite music, anywhere, anytime*
[](https://github.com/FrenzyExists/spotituby)
[](https://www.npmjs.com/package/spotituby)
[](LICENSE)
## ✨ Features
🎵 **Spotify Integration**
- Download tracks from your favorite playlists
- Access your liked songs
- Smart track selection with metadata preservation
🎬 **YouTube Support**
- Download from YouTube playlists or single videos
- High-quality audio conversion
- Automatic metadata tagging
🚀 **Easy to Use**
- Simple CLI interface
- Cross-platform support (Windows, macOS, Linux)
- Fast and efficient downloads
## 🚀 Quick Start
### Prerequisites
Before you begin, ensure you have the following installed:
📦 Required Dependencies
- **Node.js & npm** - [Download](https://nodejs.org)
```bash
node --version # Should be >= 14
```
- **Python 3** - [Download](https://python.org)
```bash
python3 --version # Should be >= 3.12
```
- **yt-dlp** - For YouTube downloads
```bash
# Linux/macOS
sudo apt install yt-dlp # Debian/Ubuntu
brew install yt-dlp # macOS
# Windows
choco install yt-dlp
```
### 🔧 Installation
1. **Install from npm**
```bash
npm install -g spotituby
```
Or clone and build:
```bash
git clone https://github.com/FrenzyExists/spotituby.git
cd spotituby
./install.sh
```
2. **Configure Spotify API**
Create a `.env` file:
```env
SPOTIFY_CLIENT_ID=your_client_id
SPOTIFY_CLIENT_SECRET=your_client_secret
```
🔑 How to get Spotify credentials
1. Visit [Spotify Developer Dashboard](https://developer.spotify.com/dashboard)
2. Create a new app
3. Add `http://localhost:3000/callback` to Redirect URIs
4. Copy Client ID and Client Secret
## 🎮 Usage
### Basic Commands
```bash
# Download from Spotify playlist
spotituby cli --url https://open.spotify.com/playlist/37i9dQZF1DX5Ejj0EkURtP
# Download from YouTube playlist
spotituby cli --url https://www.youtube.com/playlist?list=PLv9ZK9k7ZDjW5mDlMQm4eMjR4kxY9e8Ji
# Reset credentials
spotituby --reset
```
### 🎨 Features in Action
📥 Downloading Playlists
```bash
spotituby cli
# Follow the interactive prompts to:
# 1. Select a playlist
# 2. Choose tracks
# 3. Download and convert
```
🔄 Managing Authentication
```bash
# Reset stored credentials
spotituby --reset
# Start on CLI Mode
spotituby cli
```
## 🤝 Contributing
Contributions are what make the open source community amazing! Any contributions you make are **greatly appreciated**.
1. Fork the Project
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the Branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request
## 📝 License
Distributed under the MIT License. See `LICENSE` for more information.
## 🌟 Show your support
Give a ⭐️ if this project helped you!
## 📧 Contact
Detective Pikachu - [@Not__Pikachu](https://twitter.com/Not__Pikachu)
---