cgmnlm.gmi (3450B)
1 # cgmnlm @ gmn.clttr.info 2 3 'cgmnlm' is a colorful gemini line-mode client 4 => ./cgmnlm.png screenshot of 'cgmnlm' (png, 71 kB) 5 6 cgmnlm should be able to run on any POSIX-compatible system that supports BearSSL. This should be pretty much every up-to-date linux distro and BSDs. It even runs on a Raspberry Pi. 7 8 ## key features 9 * bookmarks 10 * page history 11 * regex searches within pages 12 * basic client certificate support (no autocreation of client certs currently) 13 14 ## non-features 15 * no inlining of any link type 16 * no caching of page content 17 * no persistent history 18 19 ## modifications compared to upstream 20 => https://git.sr.ht/~sircmpwn/gmni This project is of fork of Drew DeVaults 'gmni'. 21 22 I created this project for my own use, it includes the following changes that won't be included upstream. Besides this adjustments i'll try to keep track of upstream changes or send patches to upstream if appropiate. 23 24 Notable changes to upstream: 25 * colored headings & links (see next chapter) 26 * default 4 char indenting 27 * s command to search in geminispace (via geminispace.info) 28 * l command to search for backlinks to the current page (via geminispace.info) 29 * K command to remove the bookmark for the current page 30 * u command to navigate 1 path element up 31 * e[N] command to open a link or the current URI in default external program (requires `xdg-open`) 32 * t[N] command to download the content behind a link or the current URI to a temporary file 33 * T command line switch to automatically open files downloaded with `t` command (requires `xdg-open`) 34 * a command and A command line switch to toggle between preformatted text and the associated alt text 35 36 ### colors 37 The actual colors used depend on your terminal palette: 38 * heading 1: light red 39 * heading 2: light yellow 40 * heading 3: light green 41 * gemini link on same capsule: light cyan 42 * gemini link to another capsule: dark cyan 43 * non-gemini link: light magenta 44 * preformatted text: light gray 45 46 ## list of commands 47 ``` list of all cgmnlm commands 48 <Enter> read more lines (if available) 49 <url> go to url 50 [N] Follow Nth link 51 p[N] Print URL of Nth link 52 e[N] Send URL of current page or Nth link to external default program (N is optional) 53 t[N] Download content of current page or Nth link to a temporary file (N is optional) 54 b[N] Jump back N entries in history (N is optional, default 1) 55 f[N] Jump forward N entries in history (N is optional, default 1) 56 u Navigate one path element up 57 H View all page history 58 m Save bookmark 59 M Browse bookmarks 60 K Remove bookmark for current page 61 r Reload the page 62 s Search via geminispace.info 63 /<text> Search for text (POSIX regular expression) 64 n Jump to next search match 65 d[N] [path] Download page, or Nth link, to path (N is optional) 66 [N]|<prog> Pipe page, or Nth link, into program (N is optional) 67 a Toggle display of alt text instead of preformatted text 68 q Quit 69 70 [N] must be replaced with a number >= 0 71 ``` 72 73 ## how to get 74 => /sources/cgmnlm.git/ browse the source of cgmnlm on gemini 75 => https://git.sr.ht/~rwa/cgmnlm/ browse source code on sourcehut 76 => https://aur.archlinux.org/packages/?O=0&SeB=n&K=cgmnlm&outdated=&SB=n&SO=a&PP=50&do_Search=Go ArchLinux AUR packages 77 78 ### build yourself 79 80 ``` commands to build cgmnlm 81 $ git clone https://git.clttr.info/cgmnlm.git 82 $ mkdir build && cd build 83 $ ../configure 84 $ make 85 $ sudo make install 86 ``` 87 Drop me a note if you are interested in packaging or have demand for a specific package. 88 89 => index.gmi [home]