{"id":50461728,"url":"https://github.com/Automations-Project/n8n-nodes-torbox","last_synced_at":"2026-07-05T15:00:38.471Z","repository":{"id":327652293,"uuid":"1109307214","full_name":"Automations-Project/n8n-nodes-torbox","owner":"Automations-Project","description":"n8n community node to integrate TorBox: add, monitor, and manage torrent downloads via TorBox APIs in your automations.","archived":false,"fork":false,"pushed_at":"2026-01-10T15:54:50.000Z","size":10567,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-01-13T22:20:29.208Z","etag":null,"topics":["api-integration","debrid","download-manager","n8n","n8n-community-node","n8n-nodes","torbox","torrent","torrent-client","workflow-automation"],"latest_commit_sha":null,"homepage":"http://npmjs.com/package/n8n-nodes-torbox","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Automations-Project.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-03T16:12:15.000Z","updated_at":"2026-01-10T15:53:40.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Automations-Project/n8n-nodes-torbox","commit_stats":null,"previous_names":["automations-project/n8n-nodes-torbox"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/Automations-Project/n8n-nodes-torbox","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Automations-Project%2Fn8n-nodes-torbox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Automations-Project%2Fn8n-nodes-torbox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Automations-Project%2Fn8n-nodes-torbox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Automations-Project%2Fn8n-nodes-torbox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Automations-Project","download_url":"https://codeload.github.com/Automations-Project/n8n-nodes-torbox/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Automations-Project%2Fn8n-nodes-torbox/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35158308,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-05T02:00:06.290Z","response_time":100,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api-integration","debrid","download-manager","n8n","n8n-community-node","n8n-nodes","torbox","torrent","torrent-client","workflow-automation"],"created_at":"2026-06-01T05:00:26.641Z","updated_at":"2026-07-05T15:00:38.206Z","avatar_url":"https://github.com/Automations-Project.png","language":"TypeScript","funding_links":[],"categories":["*Arr Stack \u0026 Automation"],"sub_categories":["Hosting Providers (VPS, Seedbox..)"],"readme":"[![n8n.io - Workflow Automation](https://github.com/Automations-Project/n8n-nodes-torbox/raw/master/intro.png)](https://torbox.app)\n# TorBox n8n Node\n[![CI](https://github.com/Automations-Project/n8n-nodes-torbox/actions/workflows/ci.yml/badge.svg)](https://github.com/Automations-Project/n8n-nodes-torbox/actions/workflows/ci.yml)\n\n[![n8n community node](https://img.shields.io/badge/n8n-community%20node-orange)](https://docs.n8n.io/integrations/community-nodes/)\n[![TorBox API](https://img.shields.io/badge/TorBox-API-green)](https://www.postman.com/torbox/torbox/overview)\n[![n8n Nodes API](https://img.shields.io/badge/n8n%20Nodes%20API-v1-blue)](#contributing)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](#contributing)\n[![npm version](https://img.shields.io/npm/v/n8n-nodes-torbox?logo=npm)](https://www.npmjs.com/package/n8n-nodes-torbox)\n[![npm downloads](https://img.shields.io/npm/dm/n8n-nodes-torbox?logo=npm)](https://www.npmjs.com/package/n8n-nodes-torbox)\n[![n8n Node version](https://img.shields.io/github/package-json/v/Automations-Project/n8n-nodes-torbox?logo=n8n\u0026label=n8n%20node)](https://github.com/Automations-Project/n8n-nodes-torbox)\n[![n8n compatibility](https://img.shields.io/github/v/release/n8n-io/n8n?logo=n8n\u0026label=)](https://n8n.io)\n[![Node.js compatibility](https://img.shields.io/badge/Node.js-%E2%89%A520.15-green?logo=node.js)](https://nodejs.org)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.8%2B-blue?logo=typescript)](https://www.typescriptlang.org)\n[![License](https://img.shields.io/github/license/Automations-Project/n8n-nodes-torbox)](LICENSE.md)\n\n[![GitHub stars](https://img.shields.io/github/stars/Automations-Project/n8n-nodes-torbox?style=social)](https://github.com/Automations-Project/n8n-nodes-torbox/stargazers)\n[![GitHub forks](https://img.shields.io/github/forks/Automations-Project/n8n-nodes-torbox?style=social)](https://github.com/Automations-Project/n8n-nodes-torbox/network)\n[![GitHub issues](https://img.shields.io/github/issues/Automations-Project/n8n-nodes-torbox)](https://github.com/Automations-Project/n8n-nodes-torbox/issues)\n[![Last commit](https://img.shields.io/github/last-commit/Automations-Project/n8n-nodes-torbox)](https://github.com/Automations-Project/n8n-nodes-torbox/commits)\n\nThis is an n8n community node for **TorBox** cloud storage and download management service. It provides comprehensive operations for managing torrents, usenet downloads, web downloads, and cloud storage integrations.\n\n[n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform where you can host and automate your workflows locally or on cloud.\n\n## Features\n\n### 🌊 Torrents Operations\n- **Create Torrent** - Add torrents via magnet links or files\n- **Control Torrent** - Pause, resume, or delete torrents\n- **Request Download Link** - Generate download links for torrent files\n- **Get Torrent List** - Browse all your torrents\n- **Get Torrent Cached Availability** - Check if torrents are cached\n- **Export Torrent Data** - Export torrent information\n- **Get Torrent Info** - Retrieve detailed torrent metadata\n\n### 📡 Usenet Operations\n- **Create Usenet Download** - Add usenet downloads via NZB files\n- **Control Usenet Download** - Manage usenet downloads\n- **Request Download Link** - Generate download links for usenet files\n- **Get Usenet List** - Browse all your usenet downloads\n- **Get Usenet Cached Availability** - Check usenet cache status\n\n### 🌐 Web Downloads Operations\n- **Create Web Download** - Download files from direct links\n- **Control Web Download** - Manage web downloads\n- **Request Download Link** - Generate download links\n- **Get Web Download List** - Browse all web downloads\n- **Get Web Download Cached Availability** - Check cache status\n- **Get Hoster List** - List supported file hosting services\n\n### 🔔 Notifications Operations\n- **Get RSS Notification Feed** - Retrieve notifications as RSS\n- **Get Notification Feed** - Get all notifications\n- **Clear All Notifications** - Remove all notifications\n- **Clear Single Notification** - Remove specific notification\n- **Send Test Notification** - Test notification settings\n\n### 👤 User Operations\n- **Refresh API Token** - Regenerate your API token\n- **Get User Data** - Retrieve account information\n- **Add Referral To Account** - Apply referral codes\n- **Get Confirmation Code** - Retrieve confirmation codes\n\n### 📰 RSS Feeds Operations\n- **Add RSS Feed** - Subscribe to RSS feeds for automatic downloads\n- **Control RSS Feed** - Pause, resume, or delete RSS feeds\n- **Modify RSS Feed** - Update RSS feed settings\n- **Get User RSS Feeds** - List all RSS subscriptions\n- **Get RSS Feed Items** - Browse items from RSS feeds\n\n### 🔗 Integrations Operations\n- **Authenticate OAuth** - Connect cloud storage services\n- **Queue Google Drive** - Upload to Google Drive\n- **Queue Pixeldrain** - Upload to Pixeldrain\n- **Queue OneDrive** - Upload to OneDrive\n- **Queue GoFile** - Upload to GoFile\n- **Queue 1Fichier** - Upload to 1Fichier\n- **Get All Jobs** - List all integration jobs\n- **Get Specific Job** - Get job details\n- **Get All Jobs By Hash** - Find jobs by hash\n- **Cancel Specific Job** - Cancel integration jobs\n\n### 📥 Queued Downloads Operations\n- **Get Queued Downloads** - List queued downloads\n- **Control Queued Downloads** - Manage download queue\n\n### 🎬 Stream Operations\n- **Create Stream** - Generate streaming links\n- **Get Stream Data** - Retrieve stream information\n\n### 🔍 Search Operations\n- **Get Metadata By ID** - Search metadata by ID\n- **Get Metadata By Query** - Search metadata by query\n- **Get Torrent Data By ID** - Find torrents by ID\n- **Get Torrent Data By Query** - Search torrents\n- **Get Usenet Data By ID** - Find usenet by ID\n- **Get Usenet Data By Query** - Search usenet\n\n### 🏢 Vendors Operations\n- **Register New Vendor** - Create vendor account\n- **Get Vendor Account** - Retrieve vendor details\n- **Update Vendor Account** - Modify vendor settings\n- **Get Vendor TorBox Accounts** - List managed accounts\n- **Get Single Vendor TorBox Account** - Get specific account\n- **Register New User Under Vendor** - Create user accounts\n- **Remove User From Vendor** - Delete user accounts\n- **Refresh User Accounts** - Update account information\n\n### 🔄 Relay Operations\n- **Get Current Users Online** - Check online users\n- **Request Update On Torrent Info** - Force torrent info refresh\n\n### ⚙️ General Operations\n- **Get Up Status** - Check API status\n- **Get Stats** - Retrieve TorBox statistics\n- **Get Changelogs RSS Feed** - Get changelogs as RSS\n- **Get Changelogs JSON** - Get changelogs as JSON\n- **Get Speedtest Files** - Access speedtest files\n\n### ✨ Advanced Features\n- ✅ Full TorBox API v1 support\n- ✅ Comprehensive error handling\n- ✅ Binary data support for file operations\n- ✅ Pagination for large result sets\n- ✅ OAuth integration for cloud services\n- ✅ RSS feed automation\n- ✅ Multi-format download support (torrents, usenet, web)\n- ✅ Real-time streaming capabilities\n- ✅ Vendor management for resellers\n\n## Installation\n\nFollow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.\n\n### npm\n```bash\nnpm install @n8n-nodes-torbox\n```\n\n### n8n Cloud \u0026 Self-Hosted\nYou can install community nodes directly in n8n Cloud through the **Settings → Community Nodes** menu.\n\n## Credentials\n\nTo use this node, you need a TorBox API token:\n\n1. Log in to your TorBox account at [torbox.app](https://torbox.app)\n2. Navigate to **Settings → API**\n3. Generate or copy your **API Token**\n\n### Configuration\n\nIn n8n, go to **Credentials → New → TorBox API** and enter:\n\n| Field | Required | Description |\n|-------|----------|-------------|\n| API Token | Yes | Your TorBox API token |\n\n## Usage\n\n### Example 1: Create a Torrent Download\n\n1. Add the **TorBox** node to your workflow\n2. Connect your credentials\n3. Select:\n   - **Resource**: Torrents\n   - **Operation**: Create Torrent\n   - **Magnet Link**: `magnet:?xt=urn:btih:...`\n4. Execute the node\n\nThe torrent will be added to your TorBox account and start downloading.\n\n### Example 2: Get Download Link\n\n1. Add the **TorBox** node to your workflow\n2. Configure:\n   - **Resource**: Torrents\n   - **Operation**: Request Download Link\n   - **Torrent ID**: `12345`\n   - **File ID**: `67890`\n3. Execute the node\n\nReturns a direct download link for the specified file.\n\n### Example 3: List All Torrents\n\n1. Add the **TorBox** node\n2. Configure:\n   - **Resource**: Torrents\n   - **Operation**: Get Torrent List\n3. Execute the node\n\nReturns an array of all your torrents with their status and details.\n\n### Example 4: Upload to Google Drive\n\n1. Add the **TorBox** node\n2. Configure:\n   - **Resource**: Integrations\n   - **Operation**: Queue Google Drive\n   - **Torrent ID**: `12345`\n   - **File ID**: `67890`\n3. Execute the node\n\nQueues the file for upload to your connected Google Drive account.\n\n### Example 5: Add RSS Feed for Automation\n\n1. Add the **TorBox** node\n2. Configure:\n   - **Resource**: RSS Feeds\n   - **Operation**: Add RSS Feed\n   - **RSS URL**: `https://example.com/feed.xml`\n   - **Filter**: Optional regex filter\n3. Execute the node\n\nAutomatically downloads new items matching your filter from the RSS feed.\n\n### Example 6: Create Streaming Link\n\n1. Add the **TorBox** node\n2. Configure:\n   - **Resource**: Stream\n   - **Operation**: Create Stream\n   - **Torrent ID**: `12345`\n   - **File ID**: `67890`\n3. Execute the node\n\nGenerates a streaming link for direct playback in media players.\n\n## Operations Reference\n\n### Torrents Operations\n\n#### Create Torrent\nAdds a new torrent to your account.\n\n**Parameters**:\n- `magnetLink` or `torrentFile` (required): Magnet link or torrent file\n- `seed` (optional): Keep seeding after download\n- `allowZip` (optional): Allow ZIP extraction\n\n**Returns**: Torrent ID, hash, and initial status.\n\n#### Control Torrent\nManages existing torrents.\n\n**Parameters**:\n- `torrentId` (required): ID of the torrent\n- `operation` (required): `pause`, `resume`, or `delete`\n\n**Returns**: Operation status and updated torrent info.\n\n#### Request Download Link\nGenerates a direct download link.\n\n**Parameters**:\n- `torrentId` (required): ID of the torrent\n- `fileId` (required): ID of the file within torrent\n- `zipLink` (optional): Generate ZIP download link\n\n**Returns**: Download URL with expiration time.\n\n### Usenet Operations\n\n#### Create Usenet Download\nAdds a usenet download via NZB file.\n\n**Parameters**:\n- `nzbFile` (required): NZB file content or URL\n\n**Returns**: Download ID and status.\n\n### Web Downloads Operations\n\n#### Create Web Download\nDownloads files from direct links.\n\n**Parameters**:\n- `url` (required): Direct download URL\n\n**Returns**: Download ID and status.\n\n#### Get Hoster List\nLists all supported file hosting services.\n\n**Returns**: Array of supported hosters with status.\n\n### Integrations Operations\n\n#### Queue Google Drive\nUploads files to Google Drive.\n\n**Parameters**:\n- `torrentId` (required): Source torrent ID\n- `fileId` (required): File to upload\n- `folderId` (optional): Destination folder\n\n**Returns**: Job ID and status.\n\n### RSS Feeds Operations\n\n#### Add RSS Feed\nSubscribes to an RSS feed for automatic downloads.\n\n**Parameters**:\n- `rssUrl` (required): RSS feed URL\n- `filter` (optional): Regex filter for items\n- `downloadAutomatically` (optional): Auto-download matches\n\n**Returns**: RSS feed ID and configuration.\n\n### Stream Operations\n\n#### Create Stream\nGenerates streaming links for media files.\n\n**Parameters**:\n- `torrentId` (required): Source torrent\n- `fileId` (required): Media file to stream\n\n**Returns**: Streaming URL and metadata.\n\n## TorBox API Features\n\nTorBox provides a comprehensive cloud storage and download management platform with:\n\n| Feature | Status | Description |\n|---------|--------|-------------|\n| Torrent downloads | ✅ Supported | Full torrent support with caching |\n| Usenet downloads | ✅ Supported | NZB file support |\n| Web downloads | ✅ Supported | Direct link downloads |\n| Cloud integrations | ✅ Supported | Google Drive, OneDrive, etc. |\n| RSS automation | ✅ Supported | Automatic download monitoring |\n| Streaming | ✅ Supported | Direct media streaming |\n| Vendor API | ✅ Supported | Reseller management |\n| Real-time updates | ✅ Supported | Relay system for live updates |\n\n## Validation \u0026 Error Handling\n\nThe node performs comprehensive validation:\n\n### API Token\n- Must be a valid TorBox API token\n- Token is validated on first request\n\n### Error Messages\nErrors include:\n- **Validation errors**: Clear explanation of invalid parameters\n- **API errors**: HTTP status codes and TorBox error messages\n- **Network errors**: Connection issues, timeouts\n- **Authentication errors**: Invalid or expired tokens\n\nAll errors include the item index for multi-item operations.\n\n## Technical Details\n\n### Built With\n- **n8n-workflow**: Node execution framework\n- **TypeScript**: Strict typing for reliability\n- **TorBox API v1**: Official API integration\n\n### Architecture\nThe node is built with a modular architecture:\n- `TorBox.node.ts` - Main node class\n- `operators.ts` - Resource and operation definitions\n- `fields.ts` - Parameter definitions\n- `methods.ts` - Operation handler implementations\n- `execute.ts` - Execution orchestrator\n\n### API Compatibility\nTorBox API v1 provides comprehensive cloud storage and download management. This node leverages the official REST API, ensuring compatibility and reliability.\n\n## Development\n\n### Prerequisites\n- Node.js \u003e= 20.15.0\n- npm or pnpm\n- n8n instance for testing\n\n### Setup\n```bash\n# Clone the repository\ngit clone https://github.com/Automations-Project/n8n-nodes-torbox.git\ncd n8n-nodes-torbox\n\n# Install dependencies\nnpm install\n\n# Build the node\nnpm run build\n\n# Lint and format\nnpm run lint\nnpm run format\n```\n\n### Local Testing\n```bash\n# Build and install to local n8n (Windows)\nnpm run start:dev-windows\n\n# Watch mode for development\nnpm run dev\n```\n\n### Project Structure\n```\nn8n-nodes-torbox/\n├── credentials/\n│   ├── TorBoxApi.credentials.ts\n│   └── torbox.svg\n├── nodes/\n│   └── TorBox/\n│       ├── TorBox.node.ts\n│       ├── TorBox.node.json\n│       ├── torbox.svg\n│       ├── operators.ts\n│       ├── fields.ts\n│       ├── methods.ts\n│       └── execute.ts\n├── package.json\n├── tsconfig.json\n└── README.md\n```\n\n## Troubleshooting\n\n### \"Invalid API token\" error\n1. Verify your API token is correct in credentials\n2. Check that your TorBox account is active\n3. Try regenerating your API token in TorBox settings\n\n### \"Download not found\" error\n1. Confirm the torrent/download ID is correct\n2. Check if the download still exists in your account\n3. Verify you have permission to access the download\n\n### \"Integration failed\" error\n1. Ensure OAuth is properly configured for cloud services\n2. Check that you have sufficient storage space\n3. Verify the integration service is online\n\n### Streaming issues\n1. Ensure the file is a supported media format\n2. Check that the download is complete\n3. Verify your network connection supports streaming\n\n### RSS feed not working\n1. Verify the RSS feed URL is accessible\n2. Check that the filter regex is valid\n3. Ensure automatic downloads are enabled\n\n## Contributing\n\nContributions are welcome! Please:\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes with tests\n4. Submit a pull request\n\n## License\n\n[MIT](LICENSE.md)\n\n## Resources\n\n- [n8n community nodes documentation](https://docs.n8n.io/integrations/community-nodes/)\n- [TorBox API Documentation](https://www.postman.com/torbox/torbox/overview)\n- [TorBox Website](https://torbox.app)\n\n## Support\n\n- **n8n Community Forum**: [community.n8n.io](https://n8n.community?ref=nskha)\n- **Issues**: [GitHub Issues](https://github.com/Automations-Project/n8n-nodes-torbox/issues)\n- **TorBox Support**: [torbox.app/support](https://support.torbox.app/en/)\n\n**Created with ❤️ for the n8n \u0026 TorBox community**","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAutomations-Project%2Fn8n-nodes-torbox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FAutomations-Project%2Fn8n-nodes-torbox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAutomations-Project%2Fn8n-nodes-torbox/lists"}