PHPackages                             yggverse/gemini-dl - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [CLI & Console](/categories/cli)
4. /
5. yggverse/gemini-dl

ActiveProject[CLI & Console](/categories/cli)

yggverse/gemini-dl
==================

CLI downloader for Gemini protocol

00PHP

Since Nov 11Pushed 7mo ago3 watchersCompare

[ Source](https://github.com/YGGverse/gemini-dl)[ Packagist](https://packagist.org/packages/yggverse/gemini-dl)[ RSS](/packages/yggverse-gemini-dl/feed)WikiDiscussions main Synced 2d ago

READMEChangelogDependenciesVersions (1)Used By (0)

gemini-dl
=========

[](#gemini-dl)

CLI batch downloader for [Gemini protocol](https://geminiprotocol.net), inspired by `wget` and `yt-dlp` tools

At this moment, project under development, some [features](#features) already implemented and testing ([feedback](https://github.com/YGGverse/gemini-dl/issues) | [PR](https://github.com/YGGverse/gemini-dl/pull))

Interface
---------

[](#interface)

[![gemini-dl](https://private-user-images.githubusercontent.com/108541346/342936239-94a494de-62fd-4ba6-85f9-a3a238cc9cb9.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODMwNDM3OTAsIm5iZiI6MTc4MzA0MzQ5MCwicGF0aCI6Ii8xMDg1NDEzNDYvMzQyOTM2MjM5LTk0YTQ5NGRlLTYyZmQtNGJhNi04NWY5LWEzYTIzOGNjOWNiOS5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjYwNzAzJTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI2MDcwM1QwMTUxMzBaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT02ZmU5YzljOTQ2MjQ1ZWFlNDc1NTk3MWVlOGYxNjAwNTdjODY5ZDU3NjRiNzg3NTE0NmYyZmRmZjhiMTRjZDUxJlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCZyZXNwb25zZS1jb250ZW50LXR5cGU9aW1hZ2UlMkZwbmcifQ.Gw6dCrhMGu4L2QPkJTj81BNbtzPs9IZNJxwMsPBOK9E)](https://private-user-images.githubusercontent.com/108541346/342936239-94a494de-62fd-4ba6-85f9-a3a238cc9cb9.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODMwNDM3OTAsIm5iZiI6MTc4MzA0MzQ5MCwicGF0aCI6Ii8xMDg1NDEzNDYvMzQyOTM2MjM5LTk0YTQ5NGRlLTYyZmQtNGJhNi04NWY5LWEzYTIzOGNjOWNiOS5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjYwNzAzJTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI2MDcwM1QwMTUxMzBaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT02ZmU5YzljOTQ2MjQ1ZWFlNDc1NTk3MWVlOGYxNjAwNTdjODY5ZDU3NjRiNzg3NTE0NmYyZmRmZjhiMTRjZDUxJlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCZyZXNwb25zZS1jb250ZW50LXR5cGU9aW1hZ2UlMkZwbmcifQ.Gw6dCrhMGu4L2QPkJTj81BNbtzPs9IZNJxwMsPBOK9E)

Components
----------

[](#components)

- [gemini-php](https://github.com/YGGverse/gemini-php) - Client for Gemini protocol
- [gemtext-php](https://github.com/YGGverse/gemtext-php) - Parser for Gemtext
- [net-php](https://github.com/YGGverse/net-php) - Network toolkit for URL operations
- [php-cli-colors](https://github.com/mikeerickson/php-cli-colors) - CLI colors

Features
--------

[](#features)

- Grab single URL or `--crawl` entire capsule
- Multiple MIME types download (e.g. inline images and other media)
- Detailed crawler log for every request + totals
- Flexible options
    - Custom `--delay` between requests
    - Custom `--index` filename for directories
    - Custom storage location
        - Filesystem
        - FTP
    - Optional links replacement for local navigation
        - Relative (default)
        - Absolute (`--absolute`)
        - Original (`--keep`)
    - `--match` regex URL
    - `--unique` snap version or sync with existing copy
    - Configurable redirect levels to `--follow`
    - Document size limit to download

Environment
-----------

[](#environment)

```
apt install git composer php-fpm php-mbstring
```

Install
-------

[](#install)

- `git clone https://github.com/YGGverse/gemini-dl.git`
- `cd gemini-dl`
- `composer update`
- `chmod +x src/gemini-dl.php` *(for direct execution only)*

Usage
-----

[](#usage)

```
src/gemini-dl.php --source gemini://.. --target /path/to/download
```

- alternatively, launch with specified php version `/path/to/php src/gemini-dl.php`

### Options

[](#options)

```
# Required

-s, --source   - string, gemini protocol address
-t, --target   - string, absolute path to destination folder

# Optional

-a, --absolute - no value, links to absolute filepath (ignored on --keep), disabled by default
-c, --crawl    - no value, crawl document links (entire capsule download), disabled by default
-d, --delay    - integer, pause between requests to prevent abuse (seconds), 1 by default
-f, --follow   - integer, follow redirects on --crawl, 0 by default
-i, --index    - string, index filename of directory listing, index.gmi by default
-h, --help     - no value, show available commands
-k, --keep     - no value, keep original links (--crawl mode only), disabled by default
-m, --match    - string, collect links match regex rule, /.*/ by default
-r, --raw      - no value, include meta headers (--keep option ignored), disabled by default
-u, --unique   - no value, append snap version as folder timestamp, disabled by default
```

- show in CLI: `gemini-dl.php --help`

###  Health Score

16

—

LowBetter than 4% of packages

Maintenance44

Moderate activity, may be stable

Popularity0

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity13

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/108541346?v=4)[d47081](/maintainers/d47081)[@d47081](https://github.com/d47081)

![](https://avatars.githubusercontent.com/u/129769985?v=4)[YGGverse](/maintainers/YGGverse)[@YGGverse](https://github.com/YGGverse)

---

Top Contributors

[![d47081](https://avatars.githubusercontent.com/u/108541346?v=4)](https://github.com/d47081 "d47081 (3 commits)")

---

Tags

batch-downloadclidownloadergeminigemini-dlgemini-downloadgemini-protocolgemtextgmi

### Embed Badge

![Health badge](/badges/yggverse-gemini-dl/health.svg)

```
[![Health](https://phpackages.com/badges/yggverse-gemini-dl/health.svg)](https://phpackages.com/packages/yggverse-gemini-dl)
```

###  Alternatives

[illuminate/console

The Illuminate Console package.

13046.0M6.5k](/packages/illuminate-console)[styleci/cli

The CLI tool for StyleCI

71470.5k9](/packages/styleci-cli)[winbox/args

Windows command-line formatter

20720.9k21](/packages/winbox-args)[tomatophp/filament-artisan

Simple but yet powerful library for running some artisan commands for FilamentPHP

3275.4k1](/packages/tomatophp-filament-artisan)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)