YouTubeSDK 📺

The missing YouTube SDK for modern iOS Development.

Legal Notice

Disclaimer: This repository and any associated code are provided "as is" without warranty of any kind, either expressed or implied. The author of this repository does not accept any responsibility for the use or misuse of this repository or its contents. The author does not endorse any actions or consequences arising from the use of this repository. Any copies, forks, or re-uploads made by other users are not the responsibility of the author. The repository is solely intended as a Proof Of Concept for educational purposes regarding the use of a service's private API. By using this repository, you acknowledge that the author makes no claims about the accuracy, legality, or safety of the code and accepts no liability for any issues that may arise. More information can be found HERE.

📦 Installation

Add YouTubeSDK to your project via Swift Package Manager.

dependencies: [
    .package(url: "https://github.com/atpugvaraa/YouTubeSDK.git", from: "1.0.0")
]

🛠️ Quick Start

1. Playing a Video (The Easy Way)

No need to manually manage AVPlayer. Use the drop-in view:

import SwiftUI
import YouTubeSDK

struct MyPlayerView: View {
    @StateObject var player = YouTubeAVPlayer()

    var body: some View {
        YouTubePlayerView(player: player)
            .onAppear {
                // One line to load, decipher, and play
                player.load(videoId: "dQw4w9WgXcQ")
            }
    }
}

2. Music Search

Access the YouTube Music backend for rich metadata.

import YouTubeSDK

let musicClient = YouTubeMusicClient()

func searchSong() async {
    do {
        let results = try await musicClient.search("Blinding Lights")
        if let song = results.first {
            print("Found: \(song.title) by \(song.artistsDisplay)")
            // Pass song.videoId to YouTubePlayer to play it!
        }
    } catch {
        print("Error: \(error)")
    }
}

3. Authentication (Optional)

Unlock personalized data like "Liked Songs."

// 1. Show Login View
.sheet(isPresented: $showLogin) {
    GoogleLoginView { cookies in
        // 2. Save Session
        YouTubeOAuthClient.saveCookies(cookies)
    }
}

// 3. Initialize Clients with Cookies
let musicClient = YouTubeMusicClient(cookies: YouTubeOAuthClient.loadCookies())
let likedSongs = try await musicClient.getLikedSongs()

---

🤝 Credits & Inspiration

I did not invent the wheel; I refined it. This SDK stands on the shoulders of open-source giants who reverse-engineered the InnerTube API. Huge respect to:

• YouTube.js (LuanRT): The gold standard for YouTube reverse engineering.
• YouTubeKit (b5i): For proving this was possible in Swift.
• Kaset (sozercan): For the robust manual parsing strategy for YouTube Music.
• NewPipe & yt-dlp: For the deciphering logic patterns.

My goal is not to compete, but to provide a polished, Swift-native alternative that focuses on Developer Experience.

---

⚠️ Disclaimer

YouTubeSDK is an unofficial library. It is not affiliated with, endorsed by, or associated with YouTube, Google, or Alphabet Inc.

• This project is for educational and research purposes only.
• It uses internal APIs that are subject to change at any time.
• You are responsible for ensuring your usage complies with YouTube's Terms of Service.
• "YouTube", "YouTube Music", and "YouTube Charts" are registered trademarks of Google LLC.

---

License

MIT License. Built with ❤️ by Aarav Gupta.