```
 ____        __             _ _      ____              _       _____ _   _ ___
|  _ \  ___ / _| __ _ _   _| | |_   / ___|_ __ ___  __| |___  |_   _| | | |_ _|
| | | |/ _ \ |_ / _` | | | | | __| | |   | '__/ _ \/ _` / __|   | | | | | || |
| |_| |  __/  _| (_| | |_| | | |_  | |___| | |  __/ (_| \__ \   | | | |_| || |
|____/ \___|_|  \__,_|\__,_|_|\__|  \____|_|  \___|\__,_|___/   |_|  \___/|___|
```

![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)
[![Donate](https://www.shieldcn.dev/badge/Donate-sponsor-FF5E5B.svg?logo=heart&variant=secondary&theme=violet)](https://hadi.icu/donate)

# 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 two sources, controlled by `--mode`:

- `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
```

---

<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>