TuneRipperBot

TuneRipperBot is a Telegram bot that allows users to download Spotify tracks and playlists by matching them with audio from YouTube. Built using .NET 8 and following Clean Architecture principles, this project integrates the Spotify API, YouTube Data API, and yt-dlp to deliver high-quality audio to users through a simple Telegram interface.

Uses TgBotPlat.WebAPI for telegram bot implementation.

🚀 What It Does

Accepts Spotify links (tracks, albums, playlists) via Telegram messages
Accepts search queries for tracks, albums, playlists, and artists
Searches for matching audio on YouTube
Downloads and processes audio using yt-dlp
Sends the final audio files back to the user through Telegram
Includes track metadata (title, artist, album art, etc.)

🧰 Tech Stack

Area	Tools/Frameworks
Backend	C#, .NET 8, Clean Architecture
APIs	Spotify Web API, YouTube Data API, Telegram Bot API
Media Handling	yt-dlp
Database	MSSQL Server (Production), SQLite (Local/Dev)
ORM	Entity Framework Core
Web Hosting	RESTful API hosted with IIS
Deployment	Docker, CI/CD Pipelines

💡 Features

🔗 Accepts Spotify track, album, and playlist URLs
🔍 Accepts commands for searcing spotify tracks, artists, albums, and playlists
🔍 Uses YouTube API to find the best audio match
📥 Downloads high-quality audio via yt-dlp
🖼️ Embeds album art and metadata
📤 Sends audio back to user through Telegram
🧠 Caches downloads and metadata for speed
🛠️ Clean, layered architecture for easy testing and maintenance
🐳 Dockerized for easy deployment
🔁 CI/CD ready for automated build and deployment
🩺 Health check endpoints to monitor services, infrastructures, and external APIs status

🛠️ Architecture Overview

The project follows Clean Architecture, separating concerns across the following layers:

Domain – Core business logic and entities
Application – Use cases, services, interfaces
Infrastructure – External API integrations, database, file system
Presentation – REST API for Telegram Bot endpoints and Telegram bot user interaction interface
CrossCutting – For implementing cross cutting concerns

📌 Usage (High-Level Flow)

User sends a Spotify link to the Telegram bot
Bot parses the link and extracts metadata via Spotify API
YouTube is queried for the closest match using title/artist info
Audio is downloaded using yt-dlp and enriched with metadata
Bot sends the MP3 (or preferred format) back to the user in chat

📦 Deployment

The app can be deployed using Docker or IIS
Supports both SQL Server and SQLite via configuration
CI/CD pipelines can be set up to auto-deploy on push or tag

For sensitive API keys (Spotify, YouTube, Telegram), use environment variables or Docker secrets.

📬 Coming Soon

✅ User authentication or bot usage limits
🔧 Configurable audio quality and format options