seedrcc — Unofficial TypeScript API wrapper for seedr.cc

A TypeScript port of the Python seedrcc library.

---

seedrcc provides a clean TypeScript interface for the Seedr API, with full type safety and async/await support. It supports all major Seedr API endpoints and works reliably for both free and premium Seedr accounts.

Table of Contents

• ✨ Features
• 📦 Installation
• 🚀 Usage
• 🗺️ How I Found the Endpoints
• 📚 Documentation
• 🙌 Contributing
• 🙏 Credits
• 📄 License

✨ Features

• Complete API Coverage: All major Seedr API endpoints are supported.
• Works for All Users: Fully functional for both free and premium Seedr accounts.
• Fully Typed: Complete TypeScript types for all methods, models, and responses.
• Robust Authentication: Handles all auth flows (device code, password, refresh token) with automatic token refreshes.

📦 Installation

npm install seedrcc

🚀 Usage

The recommended way to authenticate is using the Device Code flow. This provides a long-term session without needing to handle passwords directly.

import { Seedr } from "seedrcc";

// 1. Get device and user codes
const codes = await Seedr.getDeviceCode();
console.log(`Go to ${codes.verificationUrl} and enter: ${codes.userCode}`);

// 2. After user authorizes in browser...
const client = await Seedr.fromDeviceCode(codes.deviceCode);
const settings = await client.getSettings();
console.log(`Success! Hello, ${settings.account.username}`);

// 3. Make API calls
const contents = await client.listContents();
console.log(`Files in root: ${contents.files.length}`);

await client.close();

📚 Documentation

For a complete guide to every available method, data model, and advanced features like saving sessions, please see the full documentation in the docs/ folder:

• 1. Getting Started
• 2. Authentication
• 3. Account Operations
• 4. Files & Folders
• 5. Torrents
• 6. Error Handling
• 7. Data Models
• 8. API Reference

🙌 Contributing

Contributions, issues, and feature requests are welcome! Feel free to check the issues page.

🙏 Credits

This library is a direct TypeScript port of the incredible Python seedrcc library. All credit for discovering the endpoints and API structure goes to the original author.

📄 License

This project is distributed under the MIT License. See LICENSE for more information.