https://github.com/dan-online/oxidized
self-hosted torrent meta-search application
https://github.com/dan-online/oxidized
indexer meta-search postgresql rust torrent
Last synced: 9 months ago
JSON representation
self-hosted torrent meta-search application
- Host: GitHub
- URL: https://github.com/dan-online/oxidized
- Owner: dan-online
- License: mit
- Created: 2024-02-23T20:50:16.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-09-25T16:08:55.000Z (9 months ago)
- Last Synced: 2025-10-04T14:57:06.004Z (9 months ago)
- Topics: indexer, meta-search, postgresql, rust, torrent
- Language: Rust
- Homepage:
- Size: 636 KB
- Stars: 3
- Watchers: 0
- Forks: 0
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[![Forks][forks-shield]][forks-url]
[![Stargazers][stars-shield]][stars-url]
[![Issues][issues-shield]][issues-url]
[![MIT License][license-shield]][license-url]
oxidized
self-hosted torrent meta-search application
with a self-building, self-updating database
powered by Rust + PostgreSQL
Report Bug
·
Request Feature
Table of Contents
## About The Project
oxidized is a torrent meta-search application designed to simplify and enhance your torrent searching experience. Built with Rust + [Rocket](https://rocket.rs), oxidized delivers a reliable and responsive API for seamless integration. Utilizing PostgreSQL for data management, oxidized ensures efficient storage and retrieval of torrent information.
### Features
- Tracker integration
- Queries the top trackers for the most relevant and up-to-date seeder/leecher information
- Self-building, self-updating database ([Spider](https://github.com/boramalper/magnetico/))
- Watches the DHT (Distributed Hash Table) for new torrents and automatically adds them to the database
- 7680 indexed torrents/hr leads to 180k+ torrents/day
- Cleans stale torrents (no seeders/leechers for 3 days)
- Torznab API
- Allows for integration with popular media management clients such as Sonarr, Radarr, and Lidarr
oxidized aims to provide a straightforward and efficient solution for anyone to index torrents, without unnecessary frills or complexities.
## Getting Started
### Docker
The easiest way to get started with oxidized is to use the provided Docker image
> Here is a sample [docker-compose.yml](docker/docker-compose.yml)
```bash
# create a network
$ docker network create oxidized
# postgres database
$ docker run -d --net oxidized --name postgres -e POSTGRES_PASSWORD=oxidized -e POSTGRES_DB=oxidized postgres:alpine
# oxidized
$ docker run -d --net oxidized -e OXIDIZED_DATABASE_URL=postgres://postgres:oxidized@postgresql/oxidized --name oxidized danonline/oxidized
```
### Configuration
oxidized requires a configuration file to run. By default, it looks for `config.toml` in the current working directory. You can override the [default values](default.toml) using the config.toml or by setting environment variables in the format of: ``OXIDIZED_{SECTION}_{KEY}``.
For example: `OXIDIZED_DATABASE_URL`
## License
Distributed under the MIT License. See [`LICENSE`](LICENSE) for more information.
## Contact
DanCodes -
Project Link: [https://github.com/dan-online/oxidized](https://github.com/dan-online/oxidized)
## Disclaimer
The information and software contained herein are provided solely for educational purposes. I am not responsible for any misuse of this software.
You, the user, are solely responsible for any actions taken or decisions made based on the information or software provided. I am not liable for any direct, indirect, incidental, consequential, or punitive damages arising from the use or misuse of this information or software.
[contributors-shield]: https://img.shields.io/github/contributors/dan-online/oxidized.svg?style=for-the-badge
[contributors-url]: https://github.com/dan-online/oxidized/graphs/contributors
[forks-shield]: https://img.shields.io/github/forks/dan-online/oxidized.svg?style=for-the-badge
[forks-url]: https://github.com/dan-online/oxidized/network/members
[stars-shield]: https://img.shields.io/github/stars/dan-online/oxidized.svg?style=for-the-badge
[stars-url]: https://github.com/dan-online/oxidized/stargazers
[issues-shield]: https://img.shields.io/github/issues/dan-online/oxidized.svg?style=for-the-badge
[issues-url]: https://github.com/dan-online/oxidized/issues
[license-shield]: https://img.shields.io/github/license/dan-online/oxidized.svg?style=for-the-badge
[license-url]: https://github.com/dan-online/oxidized/blob/master/LICENSE.txt