May 14, 2015 - Torrents load right in the browser and can be downloaded without the need for a torrent client. Magnet links are natively supported and media.
This is a Work-In-Progress collection of tools for use with the Maelstrom browser. They will allow the creation and seeding of torrent files that contain static websites.
Generator
generator.py -- Requires Python 2.7
Generates optimized torrent files from static website files.
Pirate Bay
positional arguments:
- INPUT -- One or more files or directories. 'index.html' must be in the root path of the torrent to automatically render a web page in the browser.
optional arguments:
- -h, --help -- show this help message and exit
- --outputOUTPUT, -oOUTPUT -- Path for torrent file to be output. Defaults to the torrent name, as specified, or detected.
- --nameNAME -- Name of the torrent, not seen in the browser. If not specified, detected from the torrent file name or directory.
- --tracker[TRACKER [TRACKER ...]] -- One or more trackers to include in the torrent. Not including a tracker means that the torrent can only be shared via magnet-link.
- --commentCOMMENT -- A description or comment about the torrent. Not seen in the browser.
- --webseed[URL [URL ...]] One or more URLs that contain all of the files present in the torrent. Used if normal BitTorrent seeds are unavailable. NOTE: Not compatible with magnet-links, must be used with a tracker.
- --piece-lengthPIECE_LENGTH -- Number of bytes in each piece of the torrent. MUST be a power of two (2^n). Smaller piece sizes allow web pages to load more quickly. Larger sizes hash more quickly. Default: 16384
- --include-hidden-files -- Includes files whose names begin with a '.', or are marked hidden in the filesystem.
- --no-optimize-file-order -- Disables intelligent reordering of files.
- -v, --verbose -- Enable verbose mode.
Examples
Basic usage exampleMost basic way to run, defining only an input directory. The contents of the directory are recursively included. The output torrent name will be automatically set to that of the input dir. No tracker or webseed is defined, and file order will be optimized.
You can specify an input directory, one or multiple individual files to include, or use a filesystem glob ( *.html).
Output:
Either the magnet link or the browser link can be used in Maelstrom browser to view the page.
If you don't have an index.html in the torrent directory, you will receive a warning message.
Seeding
TODO
How To Download Torrent With Maelstrom Windows 10
Once you've generated a torrent, you'll need to seed it in order for other people to view its contents. To do so, add the torrent to uTorrent, set to find the files in their original location.
Note that seeding a torrent using clients other than uTorrent or BitTorrent may result in it not being reachable in the Maelstrom browser via magnet link.
Optimizations
In order to have torrent based websites load as quickly as possible, the Generator tool makes a number of optimizations.
- Small piece length - The default piece length of 16,384 bytes means that small files (like HTML) are retrieved efficiently. This can impact performance with very large files, however.
- Root path files - Files in the root of the torrent are moved to the front of the torrent.
- File order - 'index.html' is always moved to the front of the torrent. The Generator then checks the HTML file for references to other files that are in the torrent, and moves those to the front of the torrent.
How To Download Torrent With Maelstrom 1
To disable order optimization, use the --no-optimize-file-order command line flag.
License
The contents of this repository are subject to the BitTorrent Open Source License Version 1.2 (the License). You may not copy or use this file, in either source code or executable form, except in compliance with the License. You may obtain a copy of the License at http://www.bittorrent.com/license.
Vuze
Software distributed under the License is distributed on an AS IS basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License for the specific language governing rights and limitations under the License.