{"id":16277499,"url":"https://github.com/pythops/agadir","last_synced_at":"2025-09-08T06:31:07.479Z","repository":{"id":240355269,"uuid":"802424870","full_name":"pythops/agadir","owner":"pythops","description":"blogging over the terminal","archived":false,"fork":false,"pushed_at":"2024-05-24T12:38:08.000Z","size":369,"stargazers_count":10,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-06T13:44:47.999Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Rust","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/pythops.png","metadata":{"files":{"readme":"Readme.md","changelog":null,"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}},"created_at":"2024-05-18T08:58:16.000Z","updated_at":"2024-09-09T18:19:15.000Z","dependencies_parsed_at":"2024-12-10T20:02:29.611Z","dependency_job_id":null,"html_url":"https://github.com/pythops/agadir","commit_stats":null,"previous_names":["pythops/agadir"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/pythops/agadir","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pythops%2Fagadir","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pythops%2Fagadir/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pythops%2Fagadir/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pythops%2Fagadir/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pythops","download_url":"https://codeload.github.com/pythops/agadir/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pythops%2Fagadir/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274145948,"owners_count":25230114,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-08T02:00:09.813Z","response_time":121,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":[],"created_at":"2024-10-10T18:55:11.572Z","updated_at":"2025-09-08T06:31:07.165Z","avatar_url":"https://github.com/pythops.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003ch1\u003e 🚧 Work In Progress 🚧 \u003c/h1\u003e\n  \u003cbr\u003e\n  \u003cimg src=\"assets/logo.png\"/\u003e\n  \u003cbr\u003e\n  \u003ch1\u003e Agadir (ⴰⴳⴰⴷⵉⵔ) \u003c/h1\u003e\n  \u003ch2\u003e Blogging over the terminal \u003c/h2\u003e\n\u003c/div\u003e\n\n## 🔌 Installation\n\n### 📥 Binary release\n\nYou can download the pre-built binaries from the release page [release page](https://github.com/pythops/agadir/releases)\n\n### 📦 crates.io\n\nYou can install `agadir` from [crates.io](https://crates.io/crates/agadir)\n\n```shell\ncargo install agadir\n```\n\n### ⚒️ Build from source\n\nRun the following command:\n\n```shell\ngit clone https://github.com/pythops/agadir\ncd agadir\ncargo build --release\n```\n\nThis will produce an executable file at `target/release/agadir` that you can copy to a directory in your `$PATH`.\n\n## 🛞 Naviguation\n\n`j` or `Down` : Scroll down.\n\n`k` or `Up`: Scroll up.\n\n`G`: Go to the end.\n\n`gg`: Go to the top.\n\n`Enter`: Show the content of the post.\n\n`Esc`: Go to the table of content.\n\n## 📰 Post format\n\nthe posts **should** have the following format:\n\n```\n---\ntitle: Your post title here\ncreated_at: DD/MM/YYYY\nmodified_at: DD/MM/YYYY\n---\n\nYour post content goes here in Markdown format.\n```\n\n## ⚙️ Configuration\n\nThe main directory is `$HOME/.agadir`, and it can be overriden with `AGADIR` env variable.\n\nIts structure is as follows:\n\n```\n.agadir/\n├── key\n└── posts/\n   ├── assets/\n   │  └── fig.png\n   ├── post_1.md\n   └── post_2.md\n```\n\n- `key`: This is the server signing key. It is generated once at the startup and used everytime the server restarts.\n- `posts`: This is where the posts should be located.\n- `assets`: This directory serves as a place to store images/figures for the posts.\n\n## 🚀 Deploy\n\nThe default listening port is `2222` and can be customized with `--port` or `-p` cli option.\n\n## 📋Todo\n\n- [ ] Adjust the terminal size based on the client.\n- [ ] Display images.\n- [ ] Load posts from remote git repositories.\n\n## 📸 Demo\n\n```\nssh blog.pythops.com\n```\n\n## ⚖️ License\n\nGPLv3\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpythops%2Fagadir","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpythops%2Fagadir","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpythops%2Fagadir/lists"}