Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sergiotapia/magnetissimo
Web application that indexes all popular torrent sites, and saves it to the local database.
https://github.com/sergiotapia/magnetissimo
bittorrent p2p search-engine self-hosted torrent
Last synced: 6 days ago
JSON representation
Web application that indexes all popular torrent sites, and saves it to the local database.
- Host: GitHub
- URL: https://github.com/sergiotapia/magnetissimo
- Owner: sergiotapia
- License: mit
- Created: 2016-07-22T13:50:35.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2024-01-19T02:02:21.000Z (11 months ago)
- Last Synced: 2024-11-29T09:07:05.874Z (13 days ago)
- Topics: bittorrent, p2p, search-engine, self-hosted, torrent
- Language: Elixir
- Size: 8.56 MB
- Stars: 3,004
- Watchers: 60
- Forks: 189
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- freaking_awesome_elixir - Elixir - Web application that indexes all popular torrent sites, and saves it to the local database. (Top 20 packages)
- fucking-awesome-elixir - magnetissimo - Web application that indexes all popular torrent sites, and saves it to the local database. (Examples and funny stuff)
- awesome-elixir - magnetissimo - Web application that indexes all popular torrent sites, and saves it to the local database. (Examples and funny stuff)
- StarryDivineSky - sergiotapia/magnetissimo
- awesome-homelab - Magnetissimo
README
# Magnetissimo
Magnetissimo is a self-hosted web application that indexes all
popular torrent sites and saves the magnet links to your local
database.
### Goals:
- **No javascript**
- Crawl multiple index sites for torrents and magnet links.
- Easily integrates with both [Sonarr](https://github.com/Sonarr/Sonarr) and [Radarr](https://github.com/Radarr/Radarr).
- Run without ceremony. No need for configurations.
- Easy to understand source code. Special care is taken to keep code lean and understandable.
- High performance, leveraging Elixir's GenServer and Erlang's BEAM VM.
### Usage Guide:
We want to explain how to run Magnetissimo on:
- Windows
- Linux
- Mac
**Docker Compose**
```
# Generate a secret_key with either
openssl rand -base64 64
mix phx.gen.secret
# Enter that key as SECRET_KEY_BASE in the docker-compse.yml file
SECRET_KEY_BASE=YourKeyGoesHere
# Start the application
docker compose up -d
```
If you are going to access Magnetissimo at an address besides `localhost`, add `PHX_HOST` to your environment variables. For example, to access it at `http://192.168.0.54:4000`:
```
- PHX_HOST=192.168.0.54
```
Or to access it at `https://magnetissimo.domain.tld`:
```
- PHX_HOST=magnetissimo.domain.tld
```
**Kubernetes**
```
# Generate a secret_key with either
openssl rand -base64 64
mix phx.gen.secret
Edit the k8s/deployment.yaml file, and replace the ENV SECRET_KEY_BASE with your generated key.
Edit k8s/ingress.yaml & the PHX_HOST in k8s/deployment.yaml and replace the host with your domain name.
The Postgres database is configured to use the DNS name assuming it is being deployed to the default namespace, update this in the enviroment variables if you are deploying to a different namespace.
Finaly, deploy the application to your cluster.
kubectl apply -f k8s/pvc.yaml
kubectl apply -f k8s/deployment.yaml
kubectl apply -f k8s/svc.yaml
kubectl apply -f k8s/ingress.yaml
```
**Local Development**
```
asdf install
mix deps.get
iex -S mix phx.server
```
Then visit: http://localhost:4000
### API
All endpoints returns JSON formatted information.
`/search` endpoint: http://localhost:4000/api/search/:search_term
Search returns torrents that match the `search_term` param.
`/latest` endpoint: http://localhost:4000/api/latest
Latest returns the latest 50 published_at torrents.
### Contributing:
We have a `.tool-versions` so you can use ASDF to install the right versions
really easily.
```
elixir 1.14.4
nodejs 19.8.1
```
Then `asdf install`.
You also need to have Postgres running and configure it using the `DATABASE_URL`
environment variable.
Finally set up your database with some dummy data and run the project.
```bash
mix deps.get
mix ecto.reset
iex -S mix phx.server
```
### Community
Want to talk about Magnetissimo or suggest features? We have an official Discord server.
[Click to join our official Discord server](https://discord.gg/CFtGUaW)