tlcr is a simple terminal-based client for TLDR pages, written in
TLDR pages is a collection of simplified and community-driven man pages.
tlcr is under development. It works and can be used, but testing and reporting issues is appreciated.
- Simple CLI
- Colorized Markdown rendering in the terminal
- Local file based cache
- Bash completion
- No dependencies
- Local file rendering (for authors)
- Batch download
brew tap porras/tap brew install tlcr
Or, if you want to install the latest, unreleased version:
brew tap porras/tap brew install tlcr --HEAD
There is an APT repository with signed packages of the latest tlcr version. To setup this repo and install tlcr, run the following commands (as root or with sudo):
apt-key adv --keyserver keys.gnupg.net --recv-keys ED2715FE echo "deb http://iamserg.io/deb packages main" > /etc/apt/sources.list.d/iamserg.io.list apt-get update apt-get install tlcr
See how to install from source below.
If there are no binary packages for your OS version, you can install
tlcr building it from source. See
Development for instructions.
Usage: tlcr [options] [command] -u, --update Force update (default: cache for 30 days) -r, --render Render local file (for authors) -d, --download Download the whole TLDR archive -h, --help Show this help
Displaying a page:
$ tlcr ls
Displaying a page, forcing its download (and the download of the index):
$ tlcr --update ls
Displaying a page from a local file (useful if you're contributing to TLDR pages and want to have a look before submitting a patch):
$ tlcr --render tldr/pages/common/ls.md
Downloading the whole archive (it will download everything at once and store it in the normal cache, where it will expire, in the normal way, after 30 days, when it can be downloaded either completely again, or on demand page by page, as normal):
$ tlcr --download
tlcr installed, add this to your
eval "$(tlcr --completion)"
You don't need this if you installed via Homebrew (it's automatic).
You need Crystal 0.19.x installed (it might work with older or newer versions, but that's the one that's tested).
After checking out the repo (or decompressing the tarball with the source code), run
shards to get the development
dependencies, and run
crystal build tlcr.cr (
crystal build --release tlcr.cr if you intend to install it for real
tlcr binary generated in the directory can be copied anywhere in your
- Fork it ( https://github.com/porras/tlcr/fork )
- Create your feature branch (git checkout -b my-new-feature)
- Commit your changes (git commit -am 'Add some feature')
- Push to the branch (git push origin my-new-feature)
- Create a new Pull Request
- porras Sergio Gil - creator, maintainer