first commit

README.md

@@ -0,0 +1,81 @@
+# minerva-pick
+
+Minimalne CLI do wybiorczego pobierania plikow z magnet linku.
+
+Przeplyw:
+
+1. dodaje magnet,
+2. pobiera metadane torrenta,
+3. pokazuje liste plikow,
+4. pozwala zaznaczyc pliki przez `fzf --multi`,
+5. pobiera tylko wybrane pliki przez `github.com/anacrolix/torrent`.
+
+> Uzywaj tylko wobec danych, do ktorych masz prawo dostepu i pobierania.
+
+## Wymagania
+
+- Go 1.23+
+- opcjonalnie `fzf` dla wygodnego interaktywnego wyboru
+
+Biblioteka torrentowa jest przypieta do `github.com/anacrolix/torrent v1.58.1`.
+
+## Build
+
+```bash
+go mod tidy
+go build -o minerva-pick .
+```
+
+Opcjonalnie zainstaluj `fzf`, np. na Debianie/Ubuntu:
+
+```bash
+sudo apt install fzf
+```
+
+## Uzycie
+
+```bash
+./minerva-pick 'magnet:?xt=urn:btih:...'
+```
+
+Katalog docelowy:
+
+```bash
+./minerva-pick -out ./data 'magnet:?xt=urn:btih:...'
+```
+
+Tylko lista plikow:
+
+```bash
+./minerva-pick -list 'magnet:?xt=urn:btih:...'
+```
+
+Bez `fzf`:
+
+```bash
+./minerva-pick -no-fzf 'magnet:?xt=urn:btih:...'
+```
+
+W trybie tekstowym wybor wyglada np. tak:
+
+```text
+1,3,7-10
+```
+
+albo:
+
+```text
+all
+```
+
+Timeout na metadane:
+
+```bash
+./minerva-pick -metadata-timeout 15m 'magnet:?xt=urn:btih:...'
+```
+
+## Uwagi
+
+BitTorrent pobiera dane kawalkami (pieces). Jesli wybrany plik dzieli kawalek z sasiednim, klient moze zapisac niewielka ilosc danych nalezaca do niewybranego pliku. To normalne dla selektywnego pobierania torrentow.
+
+Program nie uruchamia trybu seedowania po zakonczeniu. W trakcie pobierania klient moze wysylac fragmenty do peerow zgodnie z normalnym dzialaniem BitTorrent.