Short: BitTorrent, magnet and HTTPS downloader Author: Tatsuhiro Tsujikawa and aria2 contributors Uploader: Lastic (lasticppc@gmail.com) Type: Network/Filesharing Version: 1.37.0 Architecture: ppc-morphos Requires: MorphOS 3.20 or newer (openssl4.library), TCP/IP URL: https://aria2.github.io/ License: GPL-2.0-or-later with OpenSSL exception aria2c 1.37.0 for MorphOS (unofficial port) ============================================== OVERVIEW ======== aria2 is a small command line download utility. This is aria2c 1.37.0 for MorphOS. It downloads: - magnet links and .torrent files (BitTorrent with DHT, peer exchange, encrypted connections, UDP/HTTP/HTTPS trackers and seeding) - HTTP, HTTPS and FTP, with several connections per file As on other systems it needs no options: give it a magnet link, a .torrent file or a URL and it starts. This port is UNOFFICIAL and not supported by the aria2 authors. Please report problems with it to the porter, not to the aria2 project. It is provided "as is", without warranty of any kind. REQUIREMENTS ============ - MorphOS 3.20 or newer (tested on MorphOS 3.21). - openssl4.library, which is part of MorphOS. - A running TCP/IP stack. HTTPS certificates are checked against the CA certificates that come with MorphOS. There is nothing to set up. INSTALLATION ============ Copy the aria2c drawer wherever you like, for example to Work:Tools, and add it to the Shell search path, e.g. with this line in S:User-Startup: Path Work:Tools/aria2c ADD Keeping aria2c in its own drawer is recommended, because aria2c keeps its DHT data there (see FILES). To test the port on your machine: aria2c --a2mos-selftest USING ===== Open a Shell and give aria2c what you want to download: aria2c "magnet:?xt=urn:btih:..." aria2c Work:Torrents/some.torrent aria2c "https://example.com/file.zip" Files are saved in the current drawer. Use -d for another one: aria2c -d Work:Downloads Work:Torrents/some.torrent The status line shows the progress, the number of connections (CN) and seeders (SD), and the speed. Press Ctrl-C once to stop cleanly: aria2c saves a .aria2 control file next to the download. Run the same command again to resume. Press Ctrl-C twice to quit at once. After a BitTorrent download aria2c keeps seeding until it has uploaded as much as it downloaded. To stop as soon as the download is complete: aria2c --seed-time=0 "magnet:?xt=urn:btih:..." COMMAND LINE ============ aria2c --help shows the common options, aria2c --help=#all all of them. The full manual is at https://aria2.github.io/manual/en/html/ -d DRAWER save the files in DRAWER -o NAME file name for an HTTP/FTP download -c continue a partly downloaded HTTP/FTP file -x N up to N connections per server (HTTP/FTP) -i FILE read the downloads from FILE, one per line -Z several URLs are separate downloads (without -Z they are mirrors of one and the same file) -j N up to N downloads at the same time (default 5) -V check the files of a finished torrent -S FILE.torrent list the files in a .torrent file --select-file=1,3-5 download only some files of a torrent --seed-time=MINUTES seed for MINUTES (0 = do not seed) --max-upload-limit=50K limit the upload speed --listen-port=6881 TCP port for incoming peers --dht-listen-port=6881 UDP port for the DHT -l FILE --log-level=info write a log file --on-download-complete=COMMAND run COMMAND when a download is done --check-certificate=false HTTPS without certificate check (not recommended) --a2mos-selftest test the MorphOS port on this machine Options can also go in a configuration file (see FILES), one per line and without the leading "--", for example: dir=Work:Downloads seed-time=0 Defaults that differ from aria2c on other systems: --disable-ipv6=true IPv4 only --file-allocation=trunc sets the file size at once (no prealloc) --dht-entry-point=dht.transmissionbt.com:6881 plus dht.libtorrent.org:25401, so the DHT also starts on a fresh install MORPHOS NOTES ============= Quoting The Shell only treats a quote as quoting at the start of a word, so put the quotes around the whole option: "--on-download-complete=Work:My Scripts/done" and not, as on Unix: --on-download-complete="Work:My Scripts/done" The second form is split at the space. Put magnet links and URLs in quotes as well. Paths AmigaDOS paths work as usual: RAM:, Work:Downloads, relative drawers. The Unix forms ./ and ../ work too. A path that starts with / is read the Unix way ("/Work/Downloads" is Work:Downloads), not as the parent drawer, so use a full path instead of a leading /. No background mode --daemon has no effect. To run aria2c in the background: Run >NIL: aria2c -d Work:Downloads -l RAM:aria2.log "magnet:?..." Stop it with Break and the process number shown by Status; aria2c then stops cleanly as with Ctrl-C. One task, no threads aria2 handles all connections in one task, on every system. On a dual-core machine it therefore uses one core. Download speed depends on the network, not on that. IPv4 only While aria2c looks up a host name, everything else waits for a moment. File names and sizes SFS stores names of up to 107 characters. Longer names from torrents are shortened: aria2c keeps the extension and adds "~" and a short code, so different long names stay different. A ":" in a name becomes %3A. Files larger than 4 GB cannot be stored on an SFS partition. Hook commands --on-download-complete, --on-bt-download-complete, --on-download-error and the other --on-... options run the command in the background, with its output going to NIL:. The command gets three arguments: the download ID (GID), the number of files and the path of the first file. A script needs the S protection bit: .KEY GID/A,NUM/A,FILE/A .BRA { .KET } Echo >>RAM:done.log "Finished: {FILE}" Protect Work:Scripts/done +s Incoming connections aria2c also works without them, but other peers can only connect to you (better speed, real seeding) if the ports are forwarded on your router. Choose fixed ports and forward them (TCP and UDP): aria2c --listen-port=6881 --dht-listen-port=6881 ... FILES ===== aria2c keeps its files in the drawer given by the HOME variable, or, if HOME is not set, in its own drawer (PROGDIR:): .config/aria2/aria2.conf configuration file (create it yourself) .cache/aria2/dht.dat DHT nodes, saved when aria2c ends CONTENTS ======== aria2c the program ReadMe this file LICENSE_AND_CREDITS.txt credits and full licence texts The source code, with the MorphOS changes and build instructions (morphos/README-MORPHOS.txt), is available as aria2c-src-1.37.0.lha. CREDITS AND LICENCE =================== aria2 by Tatsuhiro Tsujikawa and the aria2 contributors, https://aria2.github.io/ - GPL-2.0-or-later, with an exception that allows linking with OpenSSL. MorphOS port by Lastic (lasticppc@gmail.com), made with the help of Claude Code (Anthropic's AI coding assistant). Building, testing and guidance on real hardware by Lastic on a PowerBook G4 15" 1.5 GHz (A1106). This port is unofficial and not supported by the aria2 authors. It is provided "as is", without warranty of any kind. See LICENSE_AND_CREDITS.txt for the full licence texts.