2017-11-05 01:48:03 +00:00
# magnetico
*Autonomous (self-hosted) BitTorrent DHT search engine suite.*
2019-01-06 11:04:06 +00:00
[](https://gitter.im/magnetico-dev/magnetico-dev)  [](https://travis-ci.org/boramalper/magnetico)  [](https://ci.appveyor.com/project/boramalper/magnetico/branch/master)  [](https://bestpractices.coreinfrastructure.org/projects/1029)
2017-11-05 01:48:03 +00:00
magnetico is the first autonomous (self-hosted) BitTorrent DHT search engine suite that is *designed
for end-users*. The suite consists of two packages:
- **magneticod:** Autonomous BitTorrent DHT crawler and metadata fetcher.
- **magneticow:** Lightweight web interface for magnetico.
Both programs, combined together, allows anyone with a decent Internet connection to access the vast
amount of torrents waiting to be discovered within the BitTorrent DHT space, *without relying on any
central entity*.
**magnetico** liberates BitTorrent from the yoke of centralised trackers & web-sites and makes it
*truly decentralised*. Finally!
## Features
- Easy installation & minimal requirements:
2019-05-25 11:45:51 +00:00
- [Pre-compiled static binaries ](https://github.com/boramalper/magnetico/releases ) and [Docker images ](https://hub.docker.com/u/boramalper ) are provided.
2018-08-27 08:15:01 +00:00
- Root access is *not* required to install or to use.
2017-11-05 01:48:03 +00:00
- Near-zero configuration:
2018-08-27 08:15:01 +00:00
- Both programs work out of the box, and **magneticow** can be used without a web-server too.
2017-11-05 01:48:03 +00:00
- Detailed, step-by-step manual to guide you through the installation.
- No reliance on any centralised entity:
2018-08-27 08:15:01 +00:00
- **magneticod** trawls the BitTorrent DHT by "going" from one node to another, and fetches the
2017-11-05 01:48:03 +00:00
metadata using the nodes without using trackers.
- Resilience:
- Unlike client-server model that web applications use, P2P networks are *chaotic* and
**magneticod** is designed to handle all the operational errors accordingly.
2018-08-27 08:15:01 +00:00
- Currently on paper, wait for the v1.0!
- High performance implementation in Go:
- **magneticod** utilizes every bit of your resources to discover as many infohashes & metadata as
2017-11-05 01:48:03 +00:00
possible.
- Built-in lightweight web interface:
- **magneticow** features a lightweight web interface to help you access the database without
getting on your way.
### Screenshots
*Click on the images to view full-screen.*
<!-- Use https://www.tablesgenerator.com/markdown_tables -->
|  |  |  |
|:-------------------------------------------------------------------------------------------------------------------------------------------------------:|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------:|:---------------------------------------------------------------------------------------------------------------------------------------------:|
| __The Homepage__ | __Searching for torrents__ | __Viewing the metadata of a torrent__ |
## Why?
BitTorrent, being a distributed P2P file sharing protocol, has long suffered because of the
centralised entities that people depended on for searching torrents (websites) and for discovering
other peers (trackers). Introduction of DHT (distributed hash table) eliminated the need for
trackers, allowing peers to discover each other through other peers and to fetch metadata from the
leechers & seeders in the network. **magnetico** is the finishing move that allows users to search
for torrents in the network, hence removing the need for centralised torrent websites.
## Installation Instructions
> **WARNING:**
>
2018-08-27 08:15:01 +00:00
> **magnetico** is still under active construction, and is considered *alpha* software. Please
2017-11-05 01:48:03 +00:00
> use **magnetico** suite with care and follow the installation instructions carefully to install
> it & secure the installation. Feel perfectly free to send bug reports, suggestions, or whatever
> comes to your mind to send to us through GitHub or personal e-mail.
> **WARNING:**
>
> Do NOT clone the [repository](https://github.com/boramalper/magnetico) to install **magnetico**,
> as it is never meant to be stable (except
> [releases](https://github.com/boramalper/magnetico/releases) of course).
2018-08-27 08:15:01 +00:00
1. Install **magneticod** first by following its [installation instructions ](cmd/magneticod/README.md ).
2017-11-05 01:48:03 +00:00
2. Install **magneticow** afterwards by following its
2018-08-27 08:15:01 +00:00
[installation instructions ](cmd/magneticow/README.md ).
2017-11-05 01:48:03 +00:00
2019-11-14 11:52:37 +00:00
### Docker
Run **magneticod** and **magneticow** with:
``` bash
make docker
```
It will run magnetico from already built image on [Docker Hub ](https://hub.docker.com/u/boramalper )!
You should access magneticow at < http: / / localhost:8080 > .
To build fresh images from source, first run:
``` bash
make image
```
Then run `make docker` . It ensures you run updated images of magnetico.
2018-12-30 17:14:31 +00:00
2017-11-05 01:48:03 +00:00
## License
2018-08-27 08:15:01 +00:00
All the code is licensed under AGPLv3, unless stated otherwise specifically. See `COPYING` for
details.
2017-11-05 01:48:03 +00:00
2018-09-02 16:26:54 +00:00
## Donations
### Patreon
https://www.patreon.com/boramalper
### PayPal
https://paypal.me/boramalper
### Cryptocurrencies (Coinbase)
- **BTC:** `3BLWjamWug3QQzcDDGwYLwuCqJyjcfYJB8`
- **LTC:** `MRWX5SGCF7EvN15gpzT5b3KQD3Z91gH8qi`
- **BCH:** `qqn07a58hax9l8pckq9j8ys6dsh2cnu4rsyztw2kj9`
- **ETH:** `0xe5A8e80bAA6129DF7eBB1B5302F9e2Ef4C6f6E62`
- **ETC:** `0x8964EcC86eaf043Bff2CdfE875E73D8095c26a58`
2017-11-05 01:48:03 +00:00
----
Dedicated to Cemile Binay, in whose hands I thrived.
2018-08-27 08:15:01 +00:00
Bora M. ALPER < bora @ boramalper . org >
