init

Signed-off-by: Hadi <[email protected]>
2026-10-05 10:58:25 +02:00 · 2026-08-27 00:05:08 +02:00
commit 624a723b16
29 changed files with 1989 additions and 0 deletions
@@ -0,0 +1,103 @@
+```
+ ____        __             _ _      ____              _       _____ _   _ ___
+|  _ \  ___ / _| __ _ _   _| | |_   / ___|_ __ ___  __| |___  |_   _| | | |_ _|
+| | | |/ _ \ |_ / _` | | | | | __| | |   | '__/ _ \/ _` / __|   | | | | | || |
+| |_| |  __/  _| (_| | |_| | | |_  | |___| | |  __/ (_| \__ \   | | | |_| || |
+|____/ \___|_|  \__,_|\__,_|_|\__|  \____|_|  \___|\__,_|___/   |_|  \___/|___|
+```
+
+![GitHub Stars](https://www.shieldcn.dev/github/stars/anotherhadi/default-creds-tui.svg?variant=outline&theme=violet)
+![Release](https://www.shieldcn.dev/github/release/anotherhadi/default-creds-tui.svg?variant=outline&theme=violet)
+![CI](https://www.shieldcn.dev/github/ci/anotherhadi/default-creds-tui.svg?variant=outline&theme=violet)
+[![Ko-fi](https://www.shieldcn.dev/badge/Ko--fi-sponsor-FF5E5B.svg?logo=kofi&variant=secondary&theme=violet)](https://ko-fi.com/anotherhadi)
+
+# Default Creds TUI
+
+> Find default credentials for many devices and software, without leaving the terminal
+
+<img alt="Default-creds-tui demo" src="./.github/assets/demo.gif" width="600" />
+
+Built with [bubbletea](https://github.com/charmbracelet/bubbletea) & Golang!
+
+Colors and styles can be customized using [ilovetui](https://github.com/anotherhadi/ilovetui), which applies theme changes across all compatible TUI applications at once.
+
+## Installation
+
+<details>
+<summary>Go install</summary>
+
+```sh
+go install github.com/anotherhadi/default-creds-tui@latest
+```
+
+</details>
+
+<details>
+<summary>Build from source</summary>
+
+```sh
+git clone https://github.com/anotherhadi/default-creds-tui
+cd default-creds-tui
+go build -o default-creds-tui ./cmd/default-creds-tui
+```
+
+</details>
+
+<details>
+<summary>NUR (Nix/NixOS)</summary>
+
+Available via [NUR](https://github.com/nix-community/NUR), under the `anotherhadi` repo:
+
+```nix
+# configuration.nix / home.nix
+environment.systemPackages = [ nur.repos.anotherhadi.default-creds-tui ];
+```
+
+</details>
+
+## Usage
+
+```
+default-creds-tui [flags]
+
+Flags:
+      --add-default-config   copy the default config file to the config path and exit
+  -c, --config string        path to config file (default "~/.config/default-creds-tui/config.yaml")
+  -m, --mode string          credential source: auto, online or local (overrides the config file)
+      --no-colors            disable colored output (used with --search)
+      --print                pressing enter prints the selected result to stdout and exits, instead of copying the password
+  -s, --search string        search from the CLI and print results directly, without launching the TUI
+  -v, --version              version for default-creds-tui
+```
+
+Credentials come from one of three sources, controlled by `--mode` (or `app.mode` in the config file):
+
+- `local`: reads YAML files from `~/.cache/default-creds/data` (e.g. a `git clone` of
+  [default-creds](https://github.com/anotherhadi/default-creds) into `~/.cache/default-creds`).
+- `online`: queries the [default-creds.hadi.icu](https://default-creds.hadi.icu) API.
+- `auto` (default): uses the local data directory if present, otherwise falls back to the API.
+
+Run `default-creds-tui --add-default-config` to write out an editable config file with all
+options and keybindings.
+
+### CLI mode
+
+Pass `--search` to print results straight to the terminal instead of launching the TUI, handy
+for scripting or piping:
+
+```sh
+default-creds-tui --search "d-link"
+default-creds-tui --search "cisco" --no-colors
+```
+
+`--print` (or `app.print_on_enter: true` in the config) turns enter itself into a picker: it prints
+the selected result to stdout and exits with status 0, instead of copying the password. Regardless
+of that setting, `P` always prints the selected result and quits.
+
+---
+
+<div align="center">
+  <a href="https://github.com/anotherhadi/default-creds-tui">github</a> |
+  <a href="https://gitlab.com/anotherhadi_mirror/default-creds-tui">gitlab (mirror)</a> |
+  <a href="https://git.hadi.icu/anotherhadi/default-creds-tui">gitea (mirror)</a>
+</div>