vndb/yhdev
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Add torreas

Browse source
This commit is contained in:
Yorhel 2023-11-03 20:11:58 +01:00
parent 6781bbe938
commit 4c6e5346e7
10 changed files with 100 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

3
dat/guestbook.md
View file

@ -17,6 +17,9 @@ respective issue tracker or send a mail to
# Entries
`2023-10-27` - kspes
: I love this tool so much! I use it on all my unix and mac machines quite often :)
`2023-09-11` - NeedM
: Nice client program but only 32bit version?

4
dat/index.md
View file

@ -19,6 +19,10 @@ the incidental article on this site. Enjoy your stay!
<!-- These announcements are parsed by mkfeed.pl, see that file for formatting -->
## Announcements <a href="/feed.atom"><img src="/img/feed_icon.png" alt="Atom feed"></a>
`2023-11-03` - New tool: torreas <!-- link: /torreas -->
: I wrote a little tool to reassemble torrent files, more information
available on its [homepage](/torreas).
`2023-09-11` - ncdu 1.19 released <!-- tags: ncdu, link: /ncdu -->
: Fixes a typo in the `--exclude-from` option and backports the CLI option to
disable natural sorting and the little indicator in the footer whether

48
dat/torreas.md Normal file
View file

@ -0,0 +1,48 @@
% Torreas - Torrent file reassembler
Torreas is a little command-line utility to reassemble torrents. It can scan
multiple directories in order to find files that are mentioned in the torrent.
It does this by only comparing file sizes and checksums, not location or file
name, so it can be used to reconstruct a torrent that you have downloaded and
archived somewhere, at some point.
## Download
Latest version <a href="/torreas/feed.atom"><img src="/img/feed_icon.png" alt="Atom feed"></a>
: 0.1 ([torreas-0.1.tar.gz](/download/torreas-0.1.tar.gz) - [changes](/torreas/changes))
Build requirements
: Zig 0.11
License
: MIT
Development version
: Available [on git](https://code.blicky.net/yorhel/torreas).
## Bugs & limitations
**Partial reassembly** is not yet supported. If a file is missing from your
local archive, torreas will give up and throw an error. Will likely get fixed
in future versions.
Torreas currently does an **exhaustive search** and is therefore able to find
*all* matching (duplicate) files. This is usually overkill, as you'll only need
one match for each file to reassemble a torrent. This totally hasn't been a
problem in my tests so far, but if there's many candidate files it may be
faster to stop searching after the first match. I may or may not fix this in
the future.
**Padding files** in torrents are not yet supported. Should be easy to fix, I
simply haven't encountered such a torrent yet.
Torreas could be a lot faster if it could use multiple cores to verify
checksums, but the current version is **single-threaded**. I don't expect this
to change anytime soon, I don't particularly enjoy writing threaded code and
Zig, in its current form, doesn't yet have the tools to help out much in this
area either.
Because torrent checksums can span multiple files, there are edge cases where
torreas will run out of memory or simply never complete while it is trying to
brute-force all possible file combinations. I may add more heuristics or manual
user feedback in the future to better handle such cases.