https://github.com/calpaterson/thehighseas

a very straightforward bittorrent tracker
https://github.com/calpaterson/thehighseas

Last synced: 4 days ago
JSON representation

a very straightforward bittorrent tracker

• Host: GitHub
• URL: https://github.com/calpaterson/thehighseas
• Owner: calpaterson
• Created: 2013-02-13T09:46:38.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2013-07-16T21:01:09.000Z (over 11 years ago)
• Last Synced: 2024-08-02T12:48:47.738Z (3 months ago)
• Language: Python
• Homepage:
• Size: 234 KB
• Stars: 28
• Watchers: 4
• Forks: 5
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-starred - calpaterson/thehighseas - a very straightforward bittorrent tracker (others)

README

        
The High Seas - a very straightforward bittorrent tracker

===========================================================

The High Seas is an easy to use bittorrent tracker with a very simple

web interface.  It was created with the aim of making it *much easier*

to start a bittorrent tracker.

Screenshot

----------

![A screenshot of THS](/img/screenshot.png "Screenshot")

Features

--------

* No setup whatsoever, just execute ```./thehighseas```

* A bittorrent tracker

  - All tracking is "public" (currently)

  - Scrape API supported

  - "Secret" swarms (see below for details)

* A simple web interface

  - Upload torrent files

  - Download torrent files

  - Check the status of swarms

Getting Started

---------------

### Prerequisites

- Python (version 2.x), with pip and virtualenv

    - On debian/ubuntu these are the packages:

       - ```python2.7```

       - ```python-pip```

       - ```python-virtualenv```

- Redis

    - On debian/ubuntu this is the package:

       - ```redis-server```

### Running

- Execute ```./thehighseas```

- Visit [http://localhost:11235](http://localhost:11235)

- Edit the configuration in ```config.sh``` before you deploy properly

"Secret" swarms

---------------

Most of the time, to start tracking a new swarm, you upload a "metainfo" file

(a ".torrent" file) to the tracker.  This file contains general information

about the files the swarm is sharing, their sizes, their names and checksums

for the files.  The tracker then hosts this metainfo file so that anyone can

join the swarm and start sharing the files.

This is fine for when you want anyone to be able to join a swarm.  Sometimes,

though, files are private.

In this case, you don't need to upload the metainfo file to THS.  Just start

sharing - THS will track any swarm that announces to it.  You'll need to

distribute the metainfo file yourself though.

Contact

-------

Email me with any questions: cal - AT - calpaterson - DOT - com