Skip to content

A tool to download music from Spotify and Youtube, free, as it should

License

Notifications You must be signed in to change notification settings

FrenzyExists/spotituby

Repository files navigation

🎵 Spotituby

Download your favorite music, anywhere, anytime

GitHub package.json version npm 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

    node --version  # Should be >= 14
  • Python 3 - Download

    python3 --version  # Should be >= 3.12
  • yt-dlp - For YouTube downloads

    # Linux/macOS
    sudo apt install yt-dlp  # Debian/Ubuntu
    brew install yt-dlp      # macOS
    
    # Windows
    choco install yt-dlp

🔧 Installation

  1. Install from npm

    npm install -g spotituby

    Or clone and build:

    git clone https://github.com/FrenzyExists/spotituby.git
    cd spotituby
    ./install.sh
  2. Configure Spotify API

    Create a .env file:

    SPOTIFY_CLIENT_ID=your_client_id
    SPOTIFY_CLIENT_SECRET=your_client_secret
    🔑 How to get Spotify credentials
    1. Visit Spotify Developer 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

# 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
spotituby cli
# Follow the interactive prompts to:
# 1. Select a playlist
# 2. Choose tracks
# 3. Download and convert
🔄 Managing Authentication
# 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


Made with ❤️ by FrenzyExists

About

A tool to download music from Spotify and Youtube, free, as it should

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published