summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--README.md38
-rw-r--r--assets/demo.gifbin0 -> 976381 bytes
-rw-r--r--docs/DEMO.md15
3 files changed, 18 insertions, 35 deletions
diff --git a/README.md b/README.md
index 86195f3..ffafb74 100644
--- a/README.md
+++ b/README.md
@@ -7,38 +7,7 @@
`gfold` is a CLI-driven application that helps you keep track of multiple Git repositories.
-```
-% gfold
-astrid ~ /home/neloth/src/astrid
- unclean (main)
- git@github.com:db/astrid.git
- neloth@housetelvanni.dev
-fev ~ /home/neloth/src/fev
- bare (issue2277)
- none
- neloth@housetelvanni.dev
-gb ~ /home/neloth/src/gb
- unpushed (dev)
- https://github.com/hrothgar/gb.git
- neloth@housetelvanni.dev
-pam ~ /home/neloth/src/pam
- clean (main)
- https://github.com/onc/pam.git
- neloth@solstheimcommunityserver.org
-```
-
-Want the classic display mode?
-Use `-d classic`.
-
-```
-% gfold -d classic
-another-day unclean main git@github.com:motm3/another-day.git
-beautiful-trip bare dev none
-damaged unpushed dev https://github.com/motm3/damaged.git
-dive unclean patch git@github.com:motm3/dive.git
-solo-dolo clean main https://github.com/motm3/solo-dolo.git
-tpm clean issue15 git@github.com:motm3/the-pale-moonlight.git
-```
+![A GIF showcasing gfold in action](assets/demo.gif)
If you'd prefer to use the classic display mode by default, and avoid setting the flag every time, you can set it in the config file (see **Usage** section).
@@ -118,7 +87,6 @@ Here is an example where we want to use the classic display mode and override al
gfold -i -d classic > $HOME/.config/gfold.toml
```
-
You can back up a config file and track its history with `git`.
On macOS, Linux, and most systems, you can link the file back to a `git` repository.
@@ -196,7 +164,7 @@ Please [file an issue](https://github.com/nickgerace/gfold/issues/new)!
## Compatibility
-`gfold` is intended to be ran on *any* tier one Rust 🦀 target.
+`gfold` is intended to be ran on _any_ tier one Rust 🦀 target.
Please [file an issue](https://github.com/nickgerace/gfold/issues) if your platform is unsupported.
## Troubleshooting and Known Issues
@@ -244,4 +212,4 @@ Name | Type | Description
[Arch Linux community repository](https://archlinux.org/packages/community/x86_64/gfold/) | packaging | the `gfold` package _(note: before moving to the community repository, the [AUR](https://github.com/orhun/PKGBUILDs) was previously used for distribution)_
["One Hundred Rust Binaries"](https://www.wezm.net/v2/posts/2020/100-rust-binaries/page2/) | article | featured `gfold`
[nixpkgs](https://github.com/NixOS/nixpkgs/blob/master/pkgs/applications/version-management/git-and-tools/gfold/default.nix) | packaging | the `gfold` package
-[nvim-gfold.lua](https://github.com/AckslD/nvim-gfold.lua) | project | a `neovim` plugin for `gfold` *([announcement Reddit post](https://www.reddit.com/r/neovim/comments/t209wy/introducing_nvimgfoldlua/))*
+[nvim-gfold.lua](https://github.com/AckslD/nvim-gfold.lua) | project | a `neovim` plugin for `gfold` _([announcement Reddit post](https://www.reddit.com/r/neovim/comments/t209wy/introducing_nvimgfoldlua/))_
diff --git a/assets/demo.gif b/assets/demo.gif
new file mode 100644
index 0000000..99a1d22
--- /dev/null
+++ b/assets/demo.gif
Binary files differ
diff --git a/docs/DEMO.md b/docs/DEMO.md
new file mode 100644
index 0000000..7d7b751
--- /dev/null
+++ b/docs/DEMO.md
@@ -0,0 +1,15 @@
+# Demo
+
+This document contains information related to the [demo GIF](../assets/demo.gif).
+
+## Attribution
+
+The demo was recorded with [asciinema](https://asciinema.org/) and was converted to a GIF using [`agg`](https://github.com/asciinema/agg).
+
+## Converting Recordings Into GIFs
+
+Using `agg`, convert the recording into a GIF.
+
+```shell
+agg --theme monokai --rows 32 --font-size 15 --idle-time-limit 2 <INPUT> <OUTPUT>
+```