{"id":13598675,"url":"https://github.com/lusingander/serie","last_synced_at":"2025-04-13T08:52:19.356Z","repository":{"id":250533858,"uuid":"834730157","full_name":"lusingander/serie","owner":"lusingander","description":"A rich git commit graph in your terminal, like magic 📚","archived":false,"fork":false,"pushed_at":"2025-03-08T04:56:34.000Z","size":11906,"stargazers_count":792,"open_issues_count":14,"forks_count":18,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-06T05:03:26.922Z","etag":null,"topics":["cli","git","git-client","git-graph","git-log","git-tools","ratatui","terminal","tui"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lusingander.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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":"2024-07-28T07:22:08.000Z","updated_at":"2025-04-05T21:58:17.000Z","dependencies_parsed_at":"2024-07-28T08:48:34.289Z","dependency_job_id":"de234c9e-04dd-4d28-a232-b02f1b89b8c5","html_url":"https://github.com/lusingander/serie","commit_stats":{"total_commits":55,"total_committers":7,"mean_commits":7.857142857142857,"dds":"0.18181818181818177","last_synced_commit":"ca2d15d101b37d1f8eb2860a5b710916f7efb69a"},"previous_names":["lusingander/serie"],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lusingander%2Fserie","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lusingander%2Fserie/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lusingander%2Fserie/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lusingander%2Fserie/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lusingander","download_url":"https://codeload.github.com/lusingander/serie/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248661713,"owners_count":21141450,"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":["cli","git","git-client","git-graph","git-log","git-tools","ratatui","terminal","tui"],"created_at":"2024-08-01T17:00:54.906Z","updated_at":"2025-04-13T08:52:19.335Z","avatar_url":"https://github.com/lusingander.png","language":"Rust","readme":"# Serie\n\n[![Crate Status](https://img.shields.io/crates/v/serie.svg)](https://crates.io/crates/serie)\n\nA rich git commit graph in your terminal, like magic 📚\n\n\u003cimg src=\"./img/demo.gif\"\u003e\n\n(This demo shows [Ratatui](https://github.com/ratatui/ratatui) repository!)\n\n## About\n\nSerie (`/zéːriə/`) is a TUI application that uses the terminal emulators' image display protocol to render commit graphs like `git log --graph --all`.\n\n### Why?\n\nWhile some users prefer to use Git via CLI, they often rely on a GUI or feature-rich TUI to view commit logs. Others may find `git log --graph` sufficient.\n\nPersonally, I found the output from `git log --graph` difficult to read, even with additional options. Learning complex tools just to view logs seemed cumbersome.\n\n### Goals\n\n- Provide a rich `git log --graph` experience in the terminal.\n- Offer commit graph-centric browsing of Git repositories.\n\n### Non-Goals\n\n- Implement a fully-featured Git client.\n- Create a TUI application with a complex UI.\n- Works in any terminal environment.\n\n## Requirements\n\n- Git\n- Supported terminal emulator\n  - Refer to [Compatibility](#compatibility) for details.\n\n## Installation\n\n### [Cargo](https://crates.io/crates/serie)\n\n```\n$ cargo install --locked serie\n```\n\n### [Arch Linux](https://archlinux.org/packages/extra/x86_64/serie/)\n\n```\n$ pacman -S serie\n```\n\n### [Homebrew (macOS)](https://github.com/lusingander/homebrew-tap/blob/master/serie.rb)\n\n```\n$ brew install lusingander/tap/serie\n```\n\n### [NetBSD](https://pkgsrc.se/devel/serie)\n\n```\n$ pkgin install serie\n```\n\n### Downloading binary\n\nYou can download pre-compiled binaries from [releases](https://github.com/lusingander/serie/releases).\n\n### Build from source\n\nIf you want to check the latest development version, build from source:\n\n```\n$ git clone https://github.com/lusingander/serie.git\n$ cd serie\n$ cargo build --release # Unless it's a release build, it's very slow.\n$ ./target/release/serie\n```\n\n## Usage\n\n### Basic\n\nRun `serie` in the directory where your git repository exists.\n\n```\n$ cd \u003cyour git repository\u003e\n$ serie\n```\n\n### Options\n\n```\nSerie - A rich git commit graph in your terminal, like magic 📚\n\nUsage: serie [OPTIONS]\n\nOptions:\n  -p, --protocol \u003cTYPE\u003e     Image protocol to render graph [default: auto] [possible values: auto, iterm, kitty]\n  -o, --order \u003cTYPE\u003e        Commit ordering algorithm [default: chrono] [possible values: chrono, topo]\n  -g, --graph-width \u003cTYPE\u003e  Commit graph image cell width [possible values: double, single]\n      --preload             Preload all graph images\n  -h, --help                Print help\n  -V, --version             Print version\n```\n\n#### -p, --protocol \\\u003cTYPE\\\u003e\n\nA protocol type for rendering images of commit graphs.\n\nBy default `auto` will guess the best supported protocol for the current terminal (if listed in [Supported terminals](#supported-terminals)).\n\n#### -o, --order \\\u003cTYPE\\\u003e\n\n`--order chrono` will order commits by commit date if possible.\n\n`--order topo` will order commits on the same branch consecutively if possible.\n\n\u003cdetails\u003e\n\u003csummary\u003eScreenshots\u003c/summary\u003e\n\n\u003cimg src=\"./img/order-chrono.png\" width=400\u003e\n\n`--order chrono`\n\n\u003cimg src=\"./img/order-topo.png\" width=400\u003e\n\n`--order topo`\n\n\u003c/details\u003e\n\n#### -g, --graph-width \\\u003cTYPE\\\u003e\n\nThe character width that a graph image unit cell occupies.\n\nIf not specified, `double` will be used automatically if there is enough width to display it, `single` otherwise.\n\n\u003cdetails\u003e\n\u003csummary\u003eScreenshots\u003c/summary\u003e\n\n\u003cimg src=\"./img/graph-width-double.png\" width=300\u003e\n\n`--graph-width double`\n\n\u003cimg src=\"./img/graph-width-single.png\" width=300\u003e\n\n`--graph-width single`\n\n\u003c/details\u003e\n\n#### --preload\n\nBy default, graph images are generated and loaded lazily as needed.\n\nIf `--preload` is specified, all graph images will be generated and loaded at startup. This can result in smoother scrolling, as the images are already available, and might reduce memory usage. However, this may lead to slower startup times, especially for large repositories.\n\n### Keybindings\n\nYou can see the keybindings by pressing the `?` key.\n\nThe default key bindings can be overridden. Please refer to [default-keybind.toml](./assets/default-keybind.toml) and add it to [config file](#config).\n\n\u003cdetails\u003e\n\u003csummary\u003eList of all default keybindings\u003c/summary\u003e\n\n#### Common\n\n| Key                            | Description | Corresponding keybind |\n| ------------------------------ | ----------- | --------------------- |\n| \u003ckbd\u003eCtrl-c\u003c/kbd\u003e \u003ckbd\u003eq\u003c/kbd\u003e | Quit app    | `force_quit` `quit`   |\n| \u003ckbd\u003e?\u003c/kbd\u003e                   | Open help   | `help_toggle`         |\n\n#### Commit List\n\n| Key                                  | Description                                        | Corresponding keybind                        |\n| ------------------------------------ | -------------------------------------------------- | -------------------------------------------- |\n| \u003ckbd\u003eDown/Up\u003c/kbd\u003e \u003ckbd\u003ej/k\u003c/kbd\u003e    | Move down/up                                       | `navigate_down` `navigate_up`                |\n| \u003ckbd\u003eAlt-Down\u003c/kbd\u003e \u003ckbd\u003eAlt-j\u003c/kbd\u003e | Move to parent commit                              | `go_to_parent`                               |\n| \u003ckbd\u003eg/G\u003c/kbd\u003e                       | Go to top/bottom                                   | `go_to_top` `go_to_bottom`                   |\n| \u003ckbd\u003eCtrl-f/b\u003c/kbd\u003e                  | Scroll page down/up                                | `page_down` `page_up`                        |\n| \u003ckbd\u003eCtrl-d/u\u003c/kbd\u003e                  | Scroll half page down/up                           | `half_page_down` `half_page_up`              |\n| \u003ckbd\u003eCtrl-e/y\u003c/kbd\u003e                  | Scroll down/up                                     | `scroll_down` `scroll_up`                    |\n| \u003ckbd\u003eH/M/L\u003c/kbd\u003e                     | Select top/middle/bottom of the screen             | `select_top` `select_middle` `select_bottom` |\n| \u003ckbd\u003eEnter\u003c/kbd\u003e                     | Show commit details\u003cbr\u003eApply search (if searching) | `confirm`                                    |\n| \u003ckbd\u003eTab\u003c/kbd\u003e                       | Open refs list                                     | `ref_list_toggle`                            |\n| \u003ckbd\u003e/\u003c/kbd\u003e                         | Start search                                       | `search`                                     |\n| \u003ckbd\u003eEsc\u003c/kbd\u003e                       | Cancel search                                      | `cancel`                                     |\n| \u003ckbd\u003en/N\u003c/kbd\u003e                       | Go to next/previous search match                   | `go_to_next` `go_to_previous`                |\n| \u003ckbd\u003ec/C\u003c/kbd\u003e                       | Copy commit short/full hash                        | `short_copy` `full_copy`                     |\n\n#### Commit Detail\n\n| Key                                 | Description                 | Corresponding keybind         |\n| ----------------------------------- | --------------------------- | ----------------------------- |\n| \u003ckbd\u003eEsc\u003c/kbd\u003e \u003ckbd\u003eBackspace\u003c/kbd\u003e | Close commit details        | `close` `cancel`              |\n| \u003ckbd\u003eDown/Up\u003c/kbd\u003e \u003ckbd\u003ej/k\u003c/kbd\u003e   | Scroll down/up              | `navigate_down` `navigate_up` |\n| \u003ckbd\u003eg/G\u003c/kbd\u003e                      | Go to top/bottom            | `go_to_top` `go_to_bottom`    |\n| \u003ckbd\u003ec/C\u003c/kbd\u003e                      | Copy commit short/full hash | `short_copy` `full_copy`      |\n\n#### Refs List\n\n| Key                                                | Description      | Corresponding keybind              |\n| -------------------------------------------------- | ---------------- | ---------------------------------- |\n| \u003ckbd\u003eEsc\u003c/kbd\u003e \u003ckbd\u003eBackspace\u003c/kbd\u003e \u003ckbd\u003eTab\u003c/kbd\u003e | Close refs list  | `close` `cancel` `ref_list_toggle` |\n| \u003ckbd\u003eDown/Up\u003c/kbd\u003e \u003ckbd\u003ej/k\u003c/kbd\u003e                  | Move down/up     | `navigate_down` `navigate_up`      |\n| \u003ckbd\u003eg/G\u003c/kbd\u003e                                     | Go to top/bottom | `go_to_top` `go_to_bottom`         |\n| \u003ckbd\u003eRight/Left\u003c/kbd\u003e \u003ckbd\u003el/h\u003c/kbd\u003e               | Open/Close node  | `navigate_right` `navigate_left`   |\n| \u003ckbd\u003ec\u003c/kbd\u003e                                       | Copy ref name    | `short_copy`                       |\n\n#### Help\n\n| Key                                              | Description      | Corresponding keybind          |\n| ------------------------------------------------ | ---------------- | ------------------------------ |\n| \u003ckbd\u003eEsc\u003c/kbd\u003e \u003ckbd\u003eBackspace\u003c/kbd\u003e \u003ckbd\u003e?\u003c/kbd\u003e | Close help       | `close` `cancel` `help_toggle` |\n| \u003ckbd\u003eDown/Up\u003c/kbd\u003e \u003ckbd\u003ej/k\u003c/kbd\u003e                | Scroll down/up   | `navigate_down` `navigate_up`  |\n| \u003ckbd\u003eg/G\u003c/kbd\u003e                                   | Go to top/bottom | `go_to_top` `go_to_bottom`     |\n\n\u003c/details\u003e\n\n### Config\n\nConfig files are loaded in the following order of priority:\n\n- `$SERIE_CONFIG_FILE`\n  - If `$SERIE_CONFIG_FILE` is set but the file does not exist, an error occurs.\n- `$XDG_CONFIG_HOME/serie/config.toml`\n  - If `$XDG_CONFIG_HOME` is not set, `~/.config/` will be used instead.\n\nIf the config file does not exist, the default values will be used for all items.\nIf the config file exists but some items are not set, the default values will be used for those unset items.\n\n\u003cdetails\u003e\n\u003csummary\u003eConfig file details\u003c/summary\u003e\n\n#### Config file format\n\nThe values set in this example are the default values.\n\n```toml\n[ui.common]\n# The type of a cursor to display in the input.\n# If `cursor_type = \"Native\"` is set, the terminal native cursor is used.\n# If `cursor_type = { \"Virtual\" = \"|\" }` is set, a virtual cursor with the specified string will be used.\n# type: enum\ncursor_type = \"Native\"\n\n[ui.list]\n# The minimum width of a subject in the commit list.\n# type: u16\nsubject_min_width = 20\n# The date format of a author date in the commit list.\n# The format must be specified in strftime format.\n# https://docs.rs/chrono/latest/chrono/format/strftime/index.html\n# type: string\ndate_format = \"%Y-%m-%d\"\n# The width of a author date in the commit list.\n# type: u16\ndate_width = 10\n# Whether to show a author date in the commit list in local timezone.\n# type: boolean\ndate_local = true\n# The width of a author name in the commit list.\n# type: u16\nname_width = 20\n\n[ui.detail]\n# The height of a commit detail area.\n# type: u16\nheight = 20\n# The date format of a author/committer date in the commit detail.\n# The format must be specified in strftime format.\n# https://docs.rs/chrono/latest/chrono/format/strftime/index.html\n# type: string\ndate_format = \"%Y-%m-%d %H:%M:%S %z\"\n# Whether to show a author/committer date in the commit list in local timezone.\n# type: boolean\ndate_local = true\n\n[ui.refs]\n# The width of a refs list area.\n# type: u16\nwidth = 26\n\n[graph.color]\n# Colors should be specified in the format #RRGGBB or #RRGGBBAA.\n\n# Array of colors used for the commit graph.\n# type: array of strings\nbranches = [\n  \"#E06C76\",\n  \"#98C379\",\n  \"#E5C07B\",\n  \"#61AFEF\",\n  \"#C678DD\",\n  \"#56B6C2\",\n]\n# Color of the edge surrounding the commit circles in the graph.\n# type: string\nedge = \"#00000000\"\n# Background color of the commit graph.\n# type: string\nbackground = \"#00000000\"\n\n[keybind]\n# See ./assets/default-keybind.toml for a specific example configuration.\n# ...\n```\n\n\u003c/details\u003e\n\n## Compatibility\n\n### Supported terminals\n\nThese image protocols are supported:\n\n- [Inline Images Protocol (iTerm2)](https://iterm2.com/documentation-images.html)\n- [Terminal graphics protocol (kitty)](https://sw.kovidgoyal.net/kitty/graphics-protocol/)\n\nThe terminals on which each has been confirmed to work are listed below.\n\n#### Inline Images Protocol\n\n| Terminal emulator                                                                | Support | Note                                                                                                                                         |\n| -------------------------------------------------------------------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------- |\n| [iTerm2](https://iterm2.com)                                                     | ○       | But slower than other terminals                                                                                                              |\n| [WezTerm](https://wezfurlong.org/wezterm/)                                       | ○       |                                                                                                                                              |\n| [VSCode integrated terminal](https://code.visualstudio.com/docs/terminal/basics) | ○       | Requires the [`terminal.integrated.enableImages` setting](https://code.visualstudio.com/docs/terminal/advanced#_image-support) to be enabled |\n| [Hyper](https://hyper.is)                                                        | △       | \u003e=[v4.0.0](https://github.com/vercel/hyper/releases/tag/v4.0.0-canary.4), not yet officially released                                        |\n| [Tabby](https://tabby.sh)                                                        | △       | The graph background is not transparent                                                                                                      |\n\n#### Terminal graphics protocol\n\n| Terminal emulator                         | Support | Note |\n| ----------------------------------------- | ------- | ---- |\n| [kitty](https://sw.kovidgoyal.net/kitty/) | ○       |      |\n| [Ghostty](https://ghostty.org)            | ○       |      |\n\n### Unsupported environments\n\n- Sixel graphics is not supported.\n- Terminal multiplexers (screen, tmux, Zellij, etc.) are not supported.\n\n## Contributing\n\nTo get started with contributing, please review [CONTRIBUTING.md](CONTRIBUTING.md).\n\nContributions that do not follow these guidelines may not be accepted.\n\n## Screenshots\n\n\u003cimg src=\"./img/list.png\" width=600\u003e\n\u003cimg src=\"./img/detail.png\" width=600\u003e\n\u003cimg src=\"./img/refs.png\" width=600\u003e\n\u003cimg src=\"./img/searching.png\" width=600\u003e\n\u003cimg src=\"./img/applied.png\" width=600\u003e\n\nThe following repositories are used as these examples:\n\n- [ratatui/ratatui](https://github.com/ratatui/ratatui)\n- [charmbracelet/vhs](https://github.com/charmbracelet/vhs)\n- [lusingander/stu](https://github.com/lusingander/stu)\n\n## License\n\nMIT\n","funding_links":[],"categories":["Rust","cli","terminal","💻 Apps","剪贴板工具","Table of Contents"],"sub_categories":["⌨️ Development Tools"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flusingander%2Fserie","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flusingander%2Fserie","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flusingander%2Fserie/lists"}