https://github.com/kozydot/korrent
A simple desktop GUI application built with Python and PyQt6 to search for torrents on 1337x using the py1337x library.
https://github.com/kozydot/korrent
1337x 1337x-api 1337x-to downloader files filesharing torrent torrent-search-api torrent-search-tool
Last synced: 11 months ago
JSON representation
A simple desktop GUI application built with Python and PyQt6 to search for torrents on 1337x using the py1337x library.
- Host: GitHub
- URL: https://github.com/kozydot/korrent
- Owner: kozydot
- License: mit
- Created: 2025-04-30T21:18:29.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2025-07-12T17:33:55.000Z (11 months ago)
- Last Synced: 2025-07-12T17:43:17.435Z (11 months ago)
- Topics: 1337x, 1337x-api, 1337x-to, downloader, files, filesharing, torrent, torrent-search-api, torrent-search-tool
- Language: Rust
- Homepage:
- Size: 305 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
A desktop torrent search application built with Python and PyQt6, featuring automatic server management and multi-provider search capabilities.
## Features
**Multi-Provider Search**
- Search across multiple torrent sources (ThePirateBay, YTS, BitSearch)
- Unified search interface with real-time results
- Advanced filtering by category, size, and quality
- **High-performance caching** with 359,000x speedup for repeated searches
**Automatic Server Management**
- Auto-start TorrentApi server when launching
- Visual server status indicators
- Graceful shutdown and cleanup
- No manual server setup required
**Modern Interface**
- Dark theme with professional styling
- Tabbed interface for search results and favorites
- Detailed torrent information with health indicators
**Additional Features**
- Favorites management
- Search history with auto-completion
- Magnet link handling
- Standalone executable generation
## Screenshot
## Architecture
This application consists of two main components:
**Korrent GUI Application** (`torrent_gui_app/`)
- Python/PyQt6 desktop application
- Modern tabbed interface with search and favorites
- Automatic server management and status monitoring
**TorrentApi Server** (`TorrentApi/`)
- Rust-based GraphQL API server
- Multi-provider torrent search backend
- High-performance concurrent searching
## Quick Start
**Option 1: Use Pre-built Executable (Recommended)**
1. Download the latest release
2. Extract the ZIP file
3. Run Korrent.exe
4. No installation required
**Option 2: Run from Source**
1. Clone the repository:
```bash
git clone https://github.com/kozydot/Korrent1337x.git
cd Korrent1337x
```
2. Install Python dependencies:
```bash
cd torrent_gui_app
pip install -r requirements.txt
```
3. Build TorrentApi server:
```bash
cd ../TorrentApi
cargo build
```
4. Run the application:
```bash
cd ../torrent_gui_app
python app.py
```
## Building Standalone Executable
Create your own standalone executable:
```bash
cd torrent_gui_app
python build_standalone.py
```
The executable will be created in `dist/Korrent.exe` with all dependencies bundled.
## Requirements
**For Running from Source:**
- Python 3.8+
- Rust 1.70+ (for building TorrentApi server)
- PyQt6, requests, pyperclip (automatically installed)
**For Pre-built Executable:**
- Windows 10/11 (64-bit)
- No additional requirements
## Usage
1. Launch Korrent (executable or `python app.py`)
2. Wait for the server status to show "Server running"
3. Enter your search query
4. Select providers and filters (optional)
5. Click "Search" to find torrents
6. Select a result to view detailed information
7. Copy magnet links or open them in your torrent client
8. Add favorites for easy access later
**Advanced Features:**
- Test Connection: Verify server connectivity
- Provider Selection: Choose specific torrent sources
- Search History: Access previous searches
- Favorites Management: Save and organize torrents
## Legal Notice
This application is designed for searching publicly available torrent files. Users are responsible for ensuring they have legal rights to download any content. Respect copyright laws in your jurisdiction.
## Contributing
Contributions are welcome! Please feel free to submit pull requests or open issues for bugs and feature requests.
## Credits
This application uses **TorrentApi** by Netfloex for torrent search functionality.
- **TorrentApi**: https://github.com/Netfloex/TorrentApi - Rust-based GraphQL torrent search API
- **PyQt6**: Cross-platform GUI framework
- **Various torrent providers**: For making content discoverable
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.