pico-torrent.1

.\" Automatically generated by Pandoc 2.9.2.1
.\"
.TH "PICO-TORRENT" "1" "March 2022" "pico-torrent 1.0" "Pindorama"
.hy
.SH NAME
.PP
pico-torrent - fast and small Torrent client
.SH SYNOPSIS
.PP
\f[B]pico-torrent\f[R] [OPTIONS]
.SH DESCRIPTION
.PP
pico-torrent support both long/GNU-styled and short/getopt-style
options.
.TP
\f[B]-h, \[en]help\f[R]
Shows a \[lq]help\[rq] message and exit.
.TP
\f[B]\[en]file FILE, -f FILE\f[R]
Informs a \f[B].torrent\f[R] file or magnet link to download.
.TP
\f[B]\[en]seeding, -S\f[R]
Keep seeding, after the download is complete.
.TP
\f[B]\[en]infos INFOS, -i INFOS\f[R]
Show torrent information.
.TP
\f[B]\[en]output, -O\f[R]
Informs the output filename, similar to \f[B]curl\f[R](1)\[cq]s option.
.TP
\f[B]\[en]link LINK, -L LINK\f[R]
Create a magnet link through a file.
.TP
\f[B]\[en]dir DIR, -d DIR\f[R]
Specify the download save directory.
.SH EXAMPLES
.PP
Download from a \f[B].torrent\f[R] file or from a magnet link:
.PD 0
.P
.PD
\f[B]pico-torrent -f
\[ti]/Downloads/78_brazil-aquarela-do-brasil_xavier-cugat-and-his-waldorf-astoria-orchestra-cugat-ch_gbia0161844a_archive.torrent
-d \[ti]/Music\f[R]
.PP
Create a magnet link from a .torrent file and send it to
\f[B]xclip\f[R](1):
.PD 0
.P
.PD
\f[B]pico-torrent -L
\[ti]/Downloads/78_brazil-aquarela-do-brasil_xavier-cugat-and-his-waldorf-astoria-orchestra-cugat-ch_gbia0161844a_archive.torrent
| xclip\f[R]
.SH HISTORY
.PP
\f[B]pico-torrent\f[R] was created around January or February 2020 \[em]
meant to be a component of otto-pkg, which was a torrent-based
repository package manager that never in fact existed \[em] by a hacker
known as Jazz_Man.
Later, it was patched by me (Luiz Ant\[^o]nio), Caio Yoshimura and
translated by apocalipse from portuguese to english.
.PP
In 2022, it got an independent repository and began to be developed
again.
It recieved important fixes from Vitor Henrique (vitorhcl) since then.
.SH AUTHORS
.PP
Jazz_Man, at the Pindorama project.
.SH BUGS
.PP
For some reason in my tests/casual usage, magnet link support seems to
be broken.
pico-torrent will be stuck at \[lq]\f[B]downloading_metadata\f[R]\[rq]
when informing a magnet link instead of a \f[B].torrent\f[R] file.
This shall be fixed in a next release.