# Torrents Digger - Digs Torrents from the Internet.

### -> Join [Matrix Room](https://matrix.to/#/#forthecommunity_space:matrix.org)


## Features

* **Multi-Source Support** – Search torrents across multiple supported torrent sources/sites.

* **Detailed Torrent Information** – View torrent creation date, size, seeders, leechers, and total download counts.

* **Advanced Filtering & Sorting** – Filter results by category and customize sorting options and sort order.

* **Bookmarks & Custom Categories** – Bookmark torrents and group them into user-defined categories for better organization and quick access.

* **Magnet Link Copying** – Copy magnet links directly to your clipboard with a single click.

* **External Torrent Client Integration** – Open magnet links directly in your preferred torrent downloader application.

* **Default Tracker Lists** – Select a default tracker list that is automatically appended to magnet links.

* **Custom Listings** – Browse curated torrent listings such as **Trending**, **Latest**, and other source-specific collections.

* **Multiple Themes** – Personalize the application's appearance with a variety of built-in themes.

* **Proxy Support** – Route traffic through proxies for enhanced privacy and accessibility.

  Supported protocols:

  * HTTP
  * HTTPS
  * SOCKS4
  * SOCKS5

* **Database Import & Export** – Back up and restore application data, including bookmarks and settings.

* **Cross-Platform Support** – Available on:

  * Android
  * Windows
  * Linux


## --> Screenshots

<details>
<summary><b>Android Screenshots</b></summary>

<br>

<p align="center">
  <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/screenshot_1.jpg" width="180">
  <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/screenshot_2.jpg" width="180">
  <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/screenshot_3.jpg" width="180">
  <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/screenshot_4.jpg" width="180">
</p>

</details>

<details>
<summary><b>Linux Screenshots</b></summary>

<br>

<p align="center">
  <a href="flatpak/screenshots/1.png">
    <img src="flatpak/screenshots/1.png" width="350">
  </a>

  <a href="flatpak/screenshots/2.png">
    <img src="flatpak/screenshots/2.png" width="350">
  </a>

  <a href="flatpak/screenshots/3.png">
    <img src="flatpak/screenshots/3.png" width="350">
  </a>

  <a href="flatpak/screenshots/4.png">
    <img src="flatpak/screenshots/4.png" width="350">
  </a>
</p>

</details>

## --> Download | Install :

<a href="https://f-droid.org/packages/org.forthecommunity.torrentsdigger">
  <img
    src="https://img.shields.io/f-droid/v/org.forthecommunity.torrentsdigger?style=flat&logo=fdroid&logoColor=white&label=Install%20from%20F-Droid&labelColor=black&color=green"
    alt="F-droid"
    width="320"
  />
</a>

<br>

<a href="https://flathub.org/apps/io.gitlab.ForTheCommunity.torrentsdigger">
  <img
    src="https://img.shields.io/flathub/v/io.gitlab.ForTheCommunity.torrentsdigger?style=flat&logo=flathub&label=Install%20from%20Flathub&labelColor=black&color=green"
    alt="Flathub"
    width="320"
  />
</a>



## --> Install using [AppMan](https://github.com/ivan-hc/AppMan)/[AM](https://github.com/ivan-hc/AM).
```
appman install torrents_digger
```

## --> Download binaries from [releases](https://gitlab.com/ForTheCommunity/torrentsdigger/-/releases) Page.


### TODOS :
- Save Search History.

- All Source Search.

- Automatically Update Bookmarked Torrent Data (Like seeders, leechers , total downloads) when Researched (opt-in,opt-out).

- Log Screen for showing Execution Logs.

- TUI APP (using Ratatui, basic project structure is made in tui directory).

- NSFW Toogle Button.


## Support
If you find this project useful, consider supporting its development.
<br>
**Monero (XMR):**
`83eg4LiD5PEWGu6JpU2mfQVmVdNJQfKzGAi5GUGZKBkBdWBaGxxUrifCj1WyiUEtUfLNaxQjcfHDaDtxfZhr7RboPCVvTYf`


## Disclaimer ->
`Torrents Digger doesn't host anything.
It just searches and lists publicly available torrents from third party sites.
Developers of Torrents Diggers can't be held responsible if anyone downloads copyrighted materials.
Becarefull what you download; ensure you are following your country's law.`


## License

This project is licensed under the **[Unlicense](https://unlicense.org)**. You can view the full license text in the [UNLICENSE](./UNLICENSE) file.


## Contribute
See [Contribution Guide](./CONTRIBUTING.md).


## Contributors :
1. [ ⧼ Shaswot Nepal ⧽ ](https://ShaswotDhungana.com.np) &nbsp;&nbsp;&nbsp; ｢ Maintainer ｣


2. [ ⧼ Wind Xebec ⧽ ](https://github.com/ybsa) &nbsp;&nbsp;&nbsp; ｢ Contributor ｣ :
- [Added Support For Windows OS.](https://gitlab.com/ForTheCommunity/torrentsdigger/-/merge_requests/3)
- [Fixed URL Launch Issue & Fixed Icon not showing issue on Taskbar in Windows OS.](https://gitlab.com/ForTheCommunity/torrentsdigger/-/merge_requests/5)
- [Fixed Scaffold Messenger / SnackBar Theme Issue.](https://gitlab.com/ForTheCommunity/torrentsdigger/-/merge_requests/6)


3. [ ⧼ Nia Ward ⧽ ](https://gitlab.com/Nia_Ward) &nbsp;&nbsp;&nbsp; ｢ Contributor ｣ :
- [Added Russian Metadata Translation for F-droid.](https://gitlab.com/ForTheCommunity/torrentsdigger/-/merge_requests/1)