0 # Vgmi

1

2 [Gemini][0] client written in C with vim-like keybindings

3

4 ## Keybindings

5

6 * k - Scroll up

7 * j - Scroll down

8 * h - Switch to the previous tab

9 * l - Switch to the next tab

10 * H - Go back in the history

11 * L - Go forward in the history

12 * gg - Go at the top of the page

13 * G - Go at the bottom of the page

14 * / - Open search mode

15 * : - Open input mode

16 * u - Open input mode with the current url

17 * f - Show the history

18 * r - Reload the page

19 * [number]Tab - Select link

20 * Tab - Follow selected link

21 * Shift+Tab - Open selected link in a new tab

22 * Del - Delete the selected link from the bookmarks

23

24 You can prefix a movement key with a number to repeat it.

25

26 ## Commands

27

28 * :q - Close the current tab

29 * :qa - Close all tabs, exit the program

30 * :o [url] - Open an url

31 * :s [search] - Search the Geminispace using geminispace.info

32 * :nt [url] - Open a new tab, the url is optional

33 * :add [name] - Add the current url to the bookmarks, the name is optional

34 * :[number] - Follow the link

35 * :gencert - Generate a certificate for the current capsule

36 * :forget [host] - Forget the certificate for the host

37 * :download [name] - Download the current page, the name is optional

38

39 ## Sandboxing

40

41 ### FreeBSD

42 On FreeBSD, Vgmi uses Capsicum to limit the filesystem and to enter capability mode, it also uses Casper for networking while in capability mode

43

44 ### OpenBSD

45 On OpenBSD, Vgmi uses Unveil to limit access to the filesystem and Pledge to restrict the capabilities of the program

46

47 ### Linux

48 On Linux, Vgmi uses Seccomp to restrict system calls and LandLock to restrict the filesystem

49

50 ## Dependencies

51

52 * [libtls][1] - a new TLS library

53 * [termbox2][2] - terminal rendering library

54

55 ### Optional dependency

56 * [stb-image][3] - image loading library

57

58 ## Building

59

60 Executing the build.sh script will download all dependencies and build Vgmi

61

62 [0]: https://gemini.circumlunar.space/

63 [1]: https://git.causal.agency/libretls/about/

64 [2]: https://github.com/termbox/termbox2

65 [3]: https://github.com/nothings/stb/blob/master/stb_image.h

66