{"id":13928777,"url":"https://github.com/zigalenarcic/mangl","last_synced_at":"2025-07-19T10:31:58.543Z","repository":{"id":36350514,"uuid":"420975443","full_name":"zigalenarcic/mangl","owner":"zigalenarcic","description":"An enhanced man page viewer for linux and BSD systems based on OpenGL and mandoc libraries","archived":false,"fork":false,"pushed_at":"2024-07-10T18:34:43.000Z","size":3863,"stargazers_count":37,"open_issues_count":6,"forks_count":7,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-08-08T18:19:58.811Z","etag":null,"topics":["bsd","desktop","linux","manpage","opengl"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zigalenarcic.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}},"created_at":"2021-10-25T10:19:57.000Z","updated_at":"2024-08-01T21:28:11.000Z","dependencies_parsed_at":"2024-03-04T20:00:33.283Z","dependency_job_id":"bbc5376b-1ba5-4986-87c0-26c71d6e4fae","html_url":"https://github.com/zigalenarcic/mangl","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zigalenarcic%2Fmangl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zigalenarcic%2Fmangl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zigalenarcic%2Fmangl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zigalenarcic%2Fmangl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zigalenarcic","download_url":"https://codeload.github.com/zigalenarcic/mangl/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":226588819,"owners_count":17655794,"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","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":["bsd","desktop","linux","manpage","opengl"],"created_at":"2024-08-07T18:01:40.492Z","updated_at":"2024-11-26T17:30:57.825Z","avatar_url":"https://github.com/zigalenarcic.png","language":"C","funding_links":[],"categories":["opengl"],"sub_categories":[],"readme":"# mangl\n\nMangl is a graphical man page viewer based on the mandoc library (https://mandoc.bsd.lv/).\n\n![Anim](screenshot/anim.gif)\n\nIt uses OpenGL with GLFW to display man pages with clickable hyperlinks and smooth scrolling.\n\nFeatures:\n* searching of man pages\n* hyperlinks to other man pages\n* search withing a man page\n* browsing history\n* colored text\n* truetype support\n* draggable scrollbar\n* keyboard and mouse interaction\n\n## Building\n\nInstall prerequisites if necessary (pkg-config, zlib, bzip2, OpenGL, GLFW and FreeType headers and\nlibraries). On Debian systems run:\n\n```\nsudo apt install pkg-config libz-dev libgl-dev libglfw3-dev libfreetype6-dev libbz2-dev\n```\n\nThen, run the usual\n\n```\n./configure\nmake\n```\n\nIf it fails, please check the Makefile for proper inclusion of OpenGL libraries.\n\nRun\n```\nsudo make install\n```\nto copy the executable to `/usr/local/bin/` or copy and use the `mangl` binary as you like.\n\n## Keyboard \u0026 mouse commands\n\n* scrolling one step: `j`, `k`, `up-arrow`, `down-arrow`\n* scrolling one whole page: `space`, `shift-space`, `page-up`, `page-down`\n* scrolling to the beginning or the end of the man page: `gg`, `G`, `Home`, `End`\n* to go to the previous man page: `b`, `escape`, `right-mouse-click`\n* to go to the next man page: `left-mouse-click` on the link, `f` to go to the page opened before going back\n* to search within a man page: `/` to initiate a search, `escape` to cancel a search, `enter` to commit the search, `n` and `N` to move between search results, search emulates vim's `smartcase` feature (use case sensitive search if the term includes uppercase letters)\n* to go to search screen: `Ctrl-f`\n* to quit: `q`, `Ctrl-c`, `Ctrl-d`\n* to toggle line length to fit the window: `=`\n\n## ~/.manglrc\n\nConfiguration can be specified with `~/.manglrc` file. Here is an example\n(reproduces default settings):\n\n```\nfont: Anonymous Pro\nfont_size: 10\ngui_scale: 1\nline_spacing: 1\nline_length: 78\ninitial_window_rows: 40\ncolor_background: #151515\ncolor_foreground: #fdfde8\ncolor_bold: #a4d4f1\ncolor_italic: #ffce79\ncolor_dim: #7b7b7b\ncolor_scrollbar_background: #262626\ncolor_scrollbar_thumb: #454545\ncolor_scrollbar_thumb_hover: #545454\ncolor_link: #4515ff\ncolor_gui_1: #ebb470\ncolor_gui_2: #8fbfdc\ncolor_error: #ff1515\ncolor_searches: #1515ff\ncolor_search_selected: #15ff15\n```\n\n`font` parameter uses the `fc-match` external program to find the font file. The font\nfile can also be specified directly.\n\n## Command line arguments\n\n```\nmangl     - open the viewer in search mode\nmangl [man page name] - open the viewer in man page mode with man page opened\nmangl [section name] [man page name] - open the man page from the specified section, e.g. mangl 3 printf\n```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzigalenarcic%2Fmangl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzigalenarcic%2Fmangl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzigalenarcic%2Fmangl/lists"}