Skip to content
/ fnc Public

An interactive ncurses browser for Fossil repositories [MIRROR ONLY]

License

Notifications You must be signed in to change notification settings

mcjsk/fnc

Repository files navigation

README

fnc 0.8

An interactive ncurses browser for Fossil repositories.

fnc uses libfossil to create a fossil ui experience in the terminal.

Tested and confirmed to run on the following amd64 systems (additional platforms noted inline):

  1. OpenBSD 6.8-, 6.9-, and 7.0-release
  2. macOS 10.15.7 (Catalina) and 11.5.2 (Big Sur)
  3. Linux Mint 20.2 (32- and 64-bit ARM)
  4. Ubuntu 18.04 running Linux kernel 5.11 (32-bit ARM)
  5. Debian GNU/Linux 8, 9, and 10
  6. CentOS 6.5 (32-bit)

Alpha development notwithstanding, the timeline, diff, tree, blame, and branch commands are relatively stable; however, there is no commitment to refrain from breaking changes.

Install

  • OpenBSD
    • doas pkg_add fnc
  • macOS
    • sudo port install fnc
  • Download and install the binary on your path

Build

  1. clone the repository
  • fossil clone https://fnc.bsdbox.org
  1. move into the repository checkout
  • cd fnc
  1. build fnc
  • make
  1. install the fnc binary (requires privileges)
  • doas make install
  1. move into an open Fossil checkout, and run it:
  • cd ~/museum/repo && fossil open ../repo.fossil && fnc

This will install the fnc executable and man page into /usr/local/bin and /usr/local/share/man/man1, respectively. Alternatively, cryptographically signed tarballs of the source code and binaries for some of the abovementioned platforms are available to download.

Doc

See fnc --help for a quick reference, and the fnc(1) manual page for more comprehensive documentation. In-app help can also be accessed with the ?, F1, or H key binding. The following video briefly demonstrates some of the key bindings in use.

fnc demo

Why

fnc is heavily inspired by tog, which I missed when I left Got (Git) behind and started using Fossil. The objective is to provide an alternative to fossil ui without leaving the terminal.

Problems & Patches

Please submit bug reports via email, the forum, or by creating a new ticket. As a rule, all reports should include a bug reproduction recipe; that is, either (1) the series of steps beginning with fossil init to create a new repository through to the fnc command that triggers the unexpected behaviour; or, if possible, (2) a shell script that contains all necessary ingredients to reproduce the problem.

Patches are thoughtfully considered and can be sent to the mailing list. While diff -up patches are preferred, fossil patch create and fossil diff patches are also welcomed. Please ensure code conforms to the C99 standard, and complies with OpenBSD's KNF style(9). Any patch containing user-visible code addition, modification, or deletion (i.e., code that impacts user interfaces) should concomitantly include updating documentation affected by the change.

Screenshots

diff vsplit diff hsplit renamed diff vsplit added diff vsplit removed blame vsplit tree vsplit branch hsplit in-app help timeline help

Trivia

fnc [fɪŋk]
noun (n.)

  1. an interactive ncurses browser for Fossil repositories
    verb (v.)
  2. to inform
    etymology
    From the German word Fink, meaning "finch", a type of bird.

About

An interactive ncurses browser for Fossil repositories [MIRROR ONLY]

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages