{"id":49077452,"url":"https://github.com/teegre/gmi","last_synced_at":"2026-04-20T10:34:29.199Z","repository":{"id":109846747,"uuid":"347944420","full_name":"teegre/gmi","owner":"teegre","description":"Gemini Capsule Generator from the command line.","archived":false,"fork":false,"pushed_at":"2025-09-04T11:03:19.000Z","size":112,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-09-04T13:08:23.611Z","etag":null,"topics":["gemini-protocol","linux","static-site-generator"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/teegre.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2021-03-15T11:35:04.000Z","updated_at":"2025-09-01T02:13:10.000Z","dependencies_parsed_at":"2023-03-13T14:03:09.769Z","dependency_job_id":null,"html_url":"https://github.com/teegre/gmi","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/teegre/gmi","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teegre%2Fgmi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teegre%2Fgmi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teegre%2Fgmi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teegre%2Fgmi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/teegre","download_url":"https://codeload.github.com/teegre/gmi/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teegre%2Fgmi/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32043170,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-20T10:33:29.490Z","status":"ssl_error","status_checked_at":"2026-04-20T10:32:30.107Z","response_time":94,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["gemini-protocol","linux","static-site-generator"],"created_at":"2026-04-20T10:34:27.963Z","updated_at":"2026-04-20T10:34:29.189Z","avatar_url":"https://github.com/teegre.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"```\n                 _\n  __ _ _ __ ___ (_)\n / _` | '_ ` _ \\| | gemini\n| (_| | | | | | | | capsule\n \\__, |_| |_| |_|_| generator\n |___/\n```\n\n# gmi: a Gemini Capsule Generator\n\n**gmi** is a Gemini capsule generator to easily manage articles, microblog posts and rss feed from the terminal.\n\n**gmi** has been tested on a **self-hosted server only**.\n\n## Dependencies\n\nbash, coreutils, findutils, fzf, nano (optional), openssh, rsync, sed, tar\n\n## Installation\n\n**gmi** is available in the Arch User Repository: [https://aur.archlinux.org/gmi.git](https://aur.archlinux.org/gmi.git)\n\nOr, clone this repository and:\n\n`make install`\n\n## Uninstall\n\n`make uninstall`\n\n## Configuration\n\nFirst, you need to copy the configuration file `/etc/gmi/config` in `$HOME/.config/gmi` and edit it.\n\n`source_dir = ~/.gmi/src`  \nCapsule source directory. Defaults to ~/.gmi/src.\n\n`backup_dir = ~/.gmi/bak`  \nBackup directory.\n\n`date_format_articles = %F`  \n`date_format_micro = %F %T`  \nArticles and microblog date format (see `man date` for more on this).\n\n`article_section_delimiter = ---`  \n\n`article_lifespan = 6`  \nIn months.  \nArticles with a creation date older or equal to this value are taken into account for archiving.  \nDefaults to 6.\n\n`yearly_archive_title = Year %y Archive`  \nTitle of yearly archive index file (%y expands to year).\n\n`rss_title =`  \n`rss_description =`  \n`capsule_url =`\n\n`server_destination_dir =`  \nFor instance `user@domain:/path`.\n\n`ssh_identity_file =`  \nOptional.\n\n`ssh_port =`  \nOptional.\n\nOnce everything is set up, enter: `gmi init`  \nIt creates the main directory structure and files for the capsule.\n\n**For convenience when deploying the capsule, you might want to disable password for rsync on the server. To do so:**\n\nOn the server, enter: `sudo visudo`  \nAnd add this line: `user ALL= NOPASSWD:/usr/bin/rsync`  \n(Replace \"user\" by your username)\n\n**Also, make sure the EDITOR environment variable is set. Gmi needs it to launch your editor of choice.**\n\nThen, you're good to go.\n\n## Basic usage\n\n**To customize your main page, enter:** `gmi idx`\n\n**To create an article, enter:** `gmi new \"My New Article\"`  \nWhen finished, a link to the article is added to the main index.gmi.\n\n**To deploy the capsule on the server:** `gmi push`  \nRSS feed is generated each time you use this command.\n\n**To add a microblog entry, enter:** `gmi post \"Hello, World!\"`  \nChanges are automatically deployed to the server.\n\n**To view list of already created articles:** `gmi list`  \nSelected article then can be:\n\n* Edited\n* Renamed\n* Archived\n* Deleted\n\nFor more info: `gmi help` or `man gmi`.\n\n## Directory structure and files\n\nArticles are stored in a YYYY/MM/DD/ID/ fashion.\n\n## Article title and renaming\n\n**gmi** assumes the first line of the file is the article's title.\n\n```\n1 | # My New Article Title\n2 |\n3 | 2021/03/15\n4 |\n5 | Article content\n```\n\n**When the title is changed inside the file, it is also changed in the main page.**\n\n```\n=\u003e 2021/03/15/1/index.gmi 2021/03/15 My New Article Title\n```\n\n## Options\n\n| Option | Description |\n|:-------|:------------|\n| init    | Create initial capsule directory structure and files. |\n| new [title] | Create a new article. |\n| post [msg]  | Post a new microblog entry. |\n| push | Deploy capsule on server. |\n| pushm | Deploy micro.gmi file only. |\n| list | Display article list. |\n| idx | Open main index for editing. |\n| idxm | Open micro.gmi for editing. |\n| idxa | Open main archive index. |\n| lista | Display archived article list. |\n| archive | Proceed archiving of older articles. |\n| backup | Create a backup copy of capsule. |\n| restore | Restore a backup copy. |\n\nWhen an article is selected, more options are available:\n\n| Option | Description |\n|:-------|:------------|\n| edit    | Open article for editing. |\n| rename  | Rename the article. |\n| archive | Archive the article. |\n| delete  | Delete the article. |\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fteegre%2Fgmi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fteegre%2Fgmi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fteegre%2Fgmi/lists"}