| 1 | |
| 2 | == Exploring and pulling texts |
| 3 | Logarion repositories are collections of text files, accompanied by a special index file.\\ |
| 4 | These collections can exist on any server and accessed by any transport protocol.\\ |
| 5 | Kosuzu's client currently supports a plethora of protocols, HTTP, FTP, Gopher to name a few examples .[^1]\\ |
| 6 | |
| 7 | A remote repository can be registered and texts copied locally.\\ |
| 8 | To add a new remote run: {{{ txt pull <url> }}}, where {{{ <url> }}} is the address of the remote repository.\\ |
| 9 | The program will connect to the server, copy the {{{ index.pck }}} file and use it to download each text file.\\ |
| 10 | It will not redownload previous texts, unless their Date or Date-Edited dates are newer than the previous ones.\\ |
| 11 | |
| 12 | The text files are by default downloaded to {{ $HOME/.local/share/texts/peers/ }}. |
| 13 | A new directory is created for each peer's unique id and the index & texts are stored in it. |
| 14 | Running {{{ txt pull }}} with no URL, will refetch indices from all previously pulled repositories, and new text files will be downloaded automatically. |
| 15 | |
| 16 | [^1]: {{{ curl }}} does not support pulling texts from Gemini servers, though |