{"id":17617397,"url":"https://github.com/yakiyo/tilde","last_synced_at":"2026-01-19T06:32:31.036Z","repository":{"id":189986976,"uuid":"681657010","full_name":"Yakiyo/tilde","owner":"Yakiyo","description":"Fast and easy-to-use terminal client for tldr","archived":false,"fork":false,"pushed_at":"2023-09-13T10:47:03.000Z","size":79,"stargazers_count":3,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-07T01:15:22.640Z","etag":null,"topics":["cli","cobra","go","man-page","tldr","tldr-client","tldr-pages"],"latest_commit_sha":null,"homepage":"","language":"Go","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/Yakiyo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"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":"2023-08-22T13:30:36.000Z","updated_at":"2024-04-11T09:03:55.000Z","dependencies_parsed_at":"2024-06-21T17:42:08.466Z","dependency_job_id":"95d0e23d-a7dd-43b5-ab9a-23915a70a8d2","html_url":"https://github.com/Yakiyo/tilde","commit_stats":null,"previous_names":["yakiyo/tilde"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/Yakiyo/tilde","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Yakiyo%2Ftilde","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Yakiyo%2Ftilde/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Yakiyo%2Ftilde/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Yakiyo%2Ftilde/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Yakiyo","download_url":"https://codeload.github.com/Yakiyo/tilde/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Yakiyo%2Ftilde/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28562405,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-19T03:31:16.861Z","status":"ssl_error","status_checked_at":"2026-01-19T03:31:15.069Z","response_time":67,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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","cobra","go","man-page","tldr","tldr-client","tldr-pages"],"created_at":"2024-10-22T19:13:27.821Z","updated_at":"2026-01-19T06:32:31.003Z","avatar_url":"https://github.com/Yakiyo.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# tilde\n[![ci](https://github.com/Yakiyo/tilde/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/Yakiyo/tilde/actions/workflows/ci.yml) ![GitHub go.mod Go version (subdirectory of monorepo)](https://img.shields.io/github/go-mod/go-version/Yakiyo/tilde) ![GitHub tag (with filter)](https://img.shields.io/github/v/tag/Yakiyo/tilde?label=version)\n\n![image](https://github.com/Yakiyo/tilde/assets/91675932/963644cc-2152-401e-b05b-bfe6d4485e6e)\n\nAn easy to use and fast console client for [tldr](https://github.com/tldr-pages/tldr)\n\nThis was inspired by the amazing [tealdeer](https://github.com/dbrgn/tealdeer). My original goal was to see wether I could write something that has the same performance as tealdeer, but alas, I couldn't achive it. It just shows that tealdeer is that good! Nevertheless it was a fun project to do, and I managed to learn more Go.\n\n## Installation\n\nDownload binaries from the [release](https://github.com/Yakiyo/tilde/releases/latest) section\n\n### Scoop\n```shell\n $ scoop install https://github.com/Yakiyo/tilde/raw/main/pkg/scoop/tilde.json\n```\n*More methods TBA*\n## Usage\nTilde follows the [tldr client specifications](https://github.com/tldr-pages/tldr/blob/main/CLIENT-SPECIFICATION.md). The version of the spec followed can be viewed by running the `tldr --version` flag. \n\nTilde stores a local cache of tldr pages in `~/.tilde/cache` directory. If it's missing, the app will warn you and you can add it with the `tldr --update` command\n\n### Basics\n```shell\n $ tldr git # search for git\n\n $ tldr git commit # search for git-log\n\n $ tldr --platform=windows cmd # search for `cmd` in windows\n\n $ tldr --language=bn zsh # search for `zsh` in Bangla language\n\n $ tldr -l cn -p osx tldr # combine `language` and `platform`\n\n $ tldr -f /path/to/some/file.md # render a custom markdown file\n\n $ tldr --raw gh # render without any formatting\n\n```\n\nYou can customize the outputs with more flags such as `--color`, `--log-level` etc. \n\nThe color flag takes one of `always` (always shows colors), `never` (disable colors) and `auto` (default). When set to auto, it tries to check if the output is a terminal and the env var `NO_COLOR` is not set.\n\nThe log-level flag can be used to customize log filters. Default is warn. You can set it to `info` to get some additional but not-necessary logs.\n\nView the entire list by running `tldr --help`.\n\n## Configuration\nTilde supports configuration via a [toml](https://toml.io) file. The default location of the file is `~/.tilde/tilde.toml`. This can specified using the command line `--config` flag. The config flag can be used to specify a custom config file to use. When the config flag is used, an error is thrown if the file does not exist in the mentioned path. If left unspecified, tilde tries to use the default file, if it is present, else uses defaults.\n\nSupported config values\n```toml\nlog_level = \"warn\" # set log level (one of info, warn, error, fatal)\ncolor = \"always\" # set color (one of always, auto, never)\nroot_dir = \"/path/to/tilde/root/dir\" # tilde's root dir. Caches and other things are stored here. defaults to ~/.tilde\nplatform = \"windows\" # set default platform to use, default is user platform\nlanguage = \"cn\" # default language to use\ncustom_pages = \"/path/to/dir\" # set a dir containing custom pages. This are prioritized before the main cache files\n```\nThe custom pages directory can be used to specify your own custom commands. This is given more priority. For example, if your custom directory contains a `zsh.md`, when using `tldr zsh`, the one in the custom directory is shown over the one in the tldr cache.\n\nYou can create a new config file by running `tldr --seed-config`. This creates a config file at `~/.tilde/tilde.toml`. **WARNING**: This will overwrite any existing configuration. `seed-config` uses the current config values. That is if used `tldr --log-level info --seed-config`, the newly created file will fill the `log_level` key with `info` instead of the default `warn`.\n## Author\n\n**tilde** © [Yakiyo](https://github.com/Yakiyo). Authored and maintained by Yakiyo.\n\nReleased under [MIT](https://opensource.org/licenses/MIT) License\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyakiyo%2Ftilde","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyakiyo%2Ftilde","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyakiyo%2Ftilde/lists"}