{"id":28797766,"url":"https://github.com/plp13/qman","last_synced_at":"2025-10-21T04:43:54.008Z","repository":{"id":197085538,"uuid":"697948523","full_name":"plp13/qman","owner":"plp13","description":"A more modern man page viewer for our terminals","archived":false,"fork":false,"pushed_at":"2025-10-18T11:36:02.000Z","size":14593,"stargazers_count":315,"open_issues_count":2,"forks_count":9,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-10-21T04:43:35.861Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-2-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/plp13.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-09-28T20:06:06.000Z","updated_at":"2025-10-20T08:02:58.000Z","dependencies_parsed_at":"2023-12-19T19:04:05.937Z","dependency_job_id":"d325f213-fd3f-46e4-97a3-03ed2195bd71","html_url":"https://github.com/plp13/qman","commit_stats":null,"previous_names":["plp13/qman"],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/plp13/qman","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plp13%2Fqman","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plp13%2Fqman/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plp13%2Fqman/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plp13%2Fqman/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/plp13","download_url":"https://codeload.github.com/plp13/qman/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plp13%2Fqman/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":280207179,"owners_count":26290616,"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-10-21T02:00:06.614Z","response_time":58,"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":"2025-06-18T05:01:00.068Z","updated_at":"2025-10-21T04:43:54.004Z","avatar_url":"https://github.com/plp13.png","language":"C","funding_links":[],"categories":["C","\u003ca name=\"system\"\u003e\u003c/a\u003eSystem tools"],"sub_categories":[],"readme":"# Qman\nA more modern manual page viewer for our terminals\n\nVersion 1.5.0 -- [see what's new](#new-in-this-version)\n\n![Screenhot -- Viewing a Manual Page](/screenshots/qman_man.png)\n\n## Get started\n\n- [Generic build instructions](doc/BUILDING.md) (works for most Linux distros)\n- [O/S specific instructions](doc/OS_SPECIFIC.md)\n- [Manual](man/qman.1.md)\n- [Troubleshooting](doc/TROUBLESHOOTING.md)\n- [Packages](doc/PACKAGES.md)\n- [Configuration and themes](config/)\n- [Contributing](doc/CONTRIBUTING.md)\n\n## Rationale\n\nUnix manual pages are lovely. They are concise, well-written, complete, and\ndownright useful. However, the standard way of accessing them from the\ncommand-line hasn't changed since the early days.\n\nQman aims to change that. It's a modern, full-featured manual page viewer\nfeaturing hyperlinks, web browser like navigation, a table of contents for each\npage, incremental search, on-line help, and more. It also strives to be fast and\ntiny, so that it can be used everywhere. For this reason, it's been written in\nplain C and has only minimal dependencies.\n\n## Features\n\n- Index page that displays all manual pages available on the system, sorted\n  alphabetically and organised by section\n- Pages for apropos and whatis results\n- Hyperlinks to other manual pages\n- Hyperlinks for URLs and email addresses\n- Hyperlinks to files or directories in the local filesystem\n- In-page hyperlinks\n- A table of contents for each manual page\n- Incremental search for manual pages\n- Incremental free page text search\n- Command-line options similar to those of `man` (most importantly, `-k` and\n  `-f`)\n- Keyboard mappings similar to those of `less`\n- Mouse support\n- Navigation history\n- On-line help\n- Fully configurable using INI-style config files\n- Manual page\n\n## Project status \n\nAll basic functionality has been completed. The software has been in use since\nlate 2023 and is considered stable. Bugs, of course, still happen. If you think\nyou have found one, please open an\n[issue](https://github.com/plp13/qman/issues).\n\n## New in this version\n\nVersion 1.5.0 introduces the following:\n- Support for several different manual page systems. Historically Qman only\n  supported `mandb`, but this is no longer the case. The program now supports\n  the following manual page systems:\n  - **[mandb](https://gitlab.com/man-db/man-db)** - most Linux distributions\n  - **[mandoc](https://mandoc.bsd.lv/)** - Void Linux, Haiku, others?\n  - **[freebsd](https://www.freebsd.org/)** - FreeBSD\n  - **[darwin](https://www.apple.com/macos/)** - macOS\n- Hyperlinks to files or directories in the local filesystem (new config\n  option `viewer_path` can be used to specify the program for opening them)\n- New `[capabilities]` config file section enables users to disable several non-\n  core program features\n- Three new themes:\n  - `adwaita`, designed to match the colors of dark Adwaita desktops\n  - `adwaita-light`, designed to match the colors of light Adwaita desktops\n  - `modernity-light`, a generic light theme to complement `modernity`\n- Re-organized and extended documentation\n- Improved error messages, especially when it comes to errors caused by\n  misconfiguration or a missing manual pages database\n- Miscellaneous other bug fixes and minor features\n\n\u003e **:bulb: Note**\n\u003e\n\u003e Users using custom config files may need to update them after a new release.\n\u003e For more information, please refer to Qman's manual page and the documentation\n\u003e in [config/README.md](config/README.md).\n\u003e\n\u003e In version 1.5.0, config options `sections_on_top`, `hyphenate` and `justify`\n\u003e have been moved to section `[capabilities]`.\n\n## More screenshots\n\nIndex page:\n![Index Page](/screenshots/qman_index.png)\n\nOpening a manual page using a pop-up:\n![Screenshot -- Opening a Manual Page](/screenshots/qman_open.png)\n\nUsing the table of contents:\n![Using the Table of Contents](/screenshots/qman_toc.png)\n\nSearching incrementally:\n![Searching incrementally](/screenshots/qman_search.png)\n\nPerforming apropos:\n![Performing Apropos](/screenshots/qman_apropos.png)\n\nOnline help:\n![Online Help](/screenshots/qman_help.png)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fplp13%2Fqman","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fplp13%2Fqman","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fplp13%2Fqman/lists"}