https://github.com/beebeeep/ncod
Minimalistic CLI password manager
https://github.com/beebeeep/ncod
cli password-manager
Last synced: 3 days ago
JSON representation
Minimalistic CLI password manager
- Host: GitHub
- URL: https://github.com/beebeeep/ncod
- Owner: beebeeep
- License: mit
- Created: 2023-10-21T20:41:42.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-02-26T09:28:19.000Z (over 2 years ago)
- Last Synced: 2026-06-09T09:59:46.243Z (3 days ago)
- Topics: cli, password-manager
- Language: C
- Homepage:
- Size: 96.7 KB
- Stars: 4
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
I can neither confirm nor deny this is a password manager, a very minimalistic one.
There certainly is a plethora of various managers with better functionality, and let's be honest - likely you _should_ use one them instead of this one.
At least unless you, like myself, are having trust issues with things that are too complex or simply not that open to fully understand. Especially around such a delicate matter as storing passwords. That being said, the main intention of the project is to create a password manager under 1K lines of (pretty simple) code, so anyone caring enough can take a look into its sources and confirm it's not doing anything fishy/stupid/too complicated. Due to this requirement, its functionality is, and probably forever will be, minimal: it only can store and get passwords from encrypted file. It doesn't do cloud synchronization, neither it has a mobile app.
Apart from that, the only other notable feature is that secret storage file of fixed size (around 766K) that can only store 1000 secrets (you can tune this value by changing STORAGE_LEN macro). The only reason for that is weird flex of hiding how much passwords you are storing and whether you do this at all (so you, essentially, can neither confirm nor deny you have passwords there).
ncod uses some external tools, which are optional, but make life better - `xclip` or `pbcopy` to copy passwords to clipboard and [fzf](https://github.com/junegunn/fzf) for browsing your secrets.
# Project status
I consider this project as stable and overall finished. The program has all the functionality I need and is still well below my self-imposed limit of 1K LoC, counting only around 570 lines.
Its functionality and interoperability has been tested on OpenBSD, Linux, and MacOS X running on x86_64, ARM64, and PPC64. No considerable changes or new features are planned, only bugfixes.
# Installation
The only runtime dependency is [libsodium](https://doc.libsodium.org/). Linux folks will also require libbsd. Build dependencies also include `pkg-config` (`pkg-conf` in FreeBSD).
```bash
make
make install # specify DESTDIR to customize
```
Default install location is `/usr/bin` in Linux and `/usr/local/bin` in BSDs (including MacOS X).
# Usage
1. Init the storage: `ncod -i [-f FILE]`
2. Store the secret: `ncod -s SECRET_ID [-f FILE]`
3. Find secret using `fzf` (`-c` to copy secret to clipboard): `ncod [-c]`
4. Get the secret (`-c` to copy secret to clipboard): `ncod -g SECRET_ID [-c] [-f FILE]`
5. List secrets: `ncod -l [-f FILE]`
6. Export secrets: `ncod -e [-f FILE]`
7. Import secrets: `ncod -m SECETS_FILE [-f FILE]`
By default, ncod stores passwords in ~/.ncod.db