Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/makew0rld/gemget
Command line downloader for the Gemini protocol.
https://github.com/makew0rld/gemget
command-line downloader gemini gemini-protocol go golang hacktoberfest
Last synced: about 2 months ago
JSON representation
Command line downloader for the Gemini protocol.
- Host: GitHub
- URL: https://github.com/makew0rld/gemget
- Owner: makew0rld
- License: mit
- Created: 2020-05-04T15:32:13.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-06-12T13:45:52.000Z (3 months ago)
- Last Synced: 2024-06-19T17:50:47.598Z (3 months ago)
- Topics: command-line, downloader, gemini, gemini-protocol, go, golang, hacktoberfest
- Language: Go
- Homepage:
- Size: 78.1 KB
- Stars: 67
- Watchers: 9
- Forks: 4
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-gemini - gemget - Command line downloader for the Gemini protocol. (Tools / Graphical)
README
# gemget
A command line downloader for the [Gemini protocol](https://gemini.circumlunar.space/).
It works well with streams and can print headers for debugging as well.
```
gemget [option]... URL...
Usage of ./gemget:
-e, --add-extension Add .gmi extensions to gemini files that don't have it, like directories.
--cert string Path to a PEM encoded TLS client certificate to be sent with the request.
--connect-timeout uint Max time allowed to form a connection and get the header, in seconds.
Set to 0 for no timeout. (default 15)
-d, --directory string
The directory where downloads go (default ".")
--header
Print out (even with --quiet) the response header to stdout in the format:
Header:
-f, --input-file string Input file with a single URL on each line. Empty lines or lines starting
with # are ignored. URLs on the command line will be processed first.
-i, --insecure Skip checking the cert
--key string Path to a PEM encoded TLS key for the provided client cert.
-m, --max-size string Set the file size limit. Any download that exceeds this size will
cause an Info output and be deleted.
Leaving it blank or setting to zero bytes will result in no limit.
This flag is ignored when outputting to stdout.
Format:
Examples: 423, 3.2KiB, '2.5 MB', '22 MiB', '10gib', 3M
-t, --max-time uint Set the downloading time limit, in seconds. Any download that
takes longer will cause an Info output and be deleted.
--no-progress-bar Disable the progress bar output.
-o, --output string Output path, for when there is only one URL.
'-' means stdout and implies --quiet.
It overrides --directory.
-p, --proxy string A proxy that can requests are sent to instead.
Can be a domain or IP with port. Port 1965 is assumed otherwise.
-q, --quiet Neither info strings or the progress bar will be printed.
Note that normally infos are printed to stderr, not stdout.
-r, --redirects uint How many redirects to follow before erroring out. (default 5)
-s, --skip Move to the next URL when one fails.
--socks string Host/address for a SOCKS5 proxy
--socks-pass string Password for a SOCKS5 proxy (optional)
--socks-user string Username for a SOCKS5 proxy (optional)
-v, --version Find out what version of gemget you're running.
```
## Project Status
gemget is in maintenance mode. See my [blog post](https://www.makeworld.space/2023/08/bye_gemini.html) for details.
## Installation
Install a binary of the most recent release from the [releases page](https://github.com/makeworld-the-better-one/gemget/releases/). On Unix-based systems you will have to make the file executable with `chmod +x `. You can rename the file to just `gemget` for easy access, and move it to `/usr/local/bin/`.
If you have Go installed, you can also install it using the Makefile. Make sure to use GNU Make.
```shell
git clone https://github.com/makeworld-the-better-one/gemget
cd gemget
# git checkout v1.2.3 # Optionally pin to a specific version instead of the latest commit
make
sudo make install
```
## Arch Linux
Arch Linux users can install gemget from AUR. It has the package name `gemget`, and is maintained by @dalz.
```shell
yay -S gemget
```
## Features to add
- [x] Support client certificates
- [ ] Support interactive input for status code 10 & 11
## License
This project is under the [MIT License](./LICENSE).