Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/emmanueltouzery/projectpad2
Projectpad allows to manage secret credentials and server information that you need to handle as a software developer or sysadmin.
https://github.com/emmanueltouzery/projectpad2
credential-storage developer-tools devops note-taking ssh
Last synced: about 1 month ago
JSON representation
Projectpad allows to manage secret credentials and server information that you need to handle as a software developer or sysadmin.
- Host: GitHub
- URL: https://github.com/emmanueltouzery/projectpad2
- Owner: emmanueltouzery
- License: mit
- Created: 2020-03-13T20:02:14.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-04-22T20:38:17.000Z (8 months ago)
- Last Synced: 2024-10-16T05:35:46.027Z (about 2 months ago)
- Topics: credential-storage, developer-tools, devops, note-taking, ssh
- Language: Rust
- Homepage:
- Size: 1.44 MB
- Stars: 87
- Watchers: 3
- Forks: 4
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
- awesome-starred - emmanueltouzery/projectpad2 - Projectpad allows to manage secret credentials and server information that you need to handle as a software developer or sysadmin. (devops)
README
# Projectpad
Projectpad allows to manage secret credentials and server information that you need to handle as a software developer or system administrator. List of servers, list of point of interests on those servers (applications, log files, databases, servers). It will securely store passwords and keys. It will also allow you to run commands (locally or on SSH servers), open terminals on remote SSH servers, and so on.
The data is securely stored on-disk using [SQLcipher][], which uses 256-bit AES. The database is password-protected, but you can store the password in your OS keyring. Since the database is encrypted, you can put it in your dropbox (or similar account), to share it between computers.
Projectpad's target audience are people who today have to use several tools to do their work effectively: a keepass-like application, a series of text files with notes, and a few shell scripts. Instead of that, projectpad offers a streamlined, integrated solution.
Projectpad consists of two applications:
1. the GUI `projectpad` application, which allows you to enter/edit data, search it, open websites and so on;
2. the command-line `ppcli` application, which allows you to run commands, connect to servers, open files of interest and so on.
See [the help](https://github.com/emmanueltouzery/projectpad2/wiki/Help) for more details about the structure of the data that you can manage in projectpad.
## GUI application
The application allows you to manage your database of projects info. It is organized in three panes:
- projects
- project items (servers, project notes, project point of interests, server links)
- project item contents (for servers that may be a number of sub-items)
At the top of the second pane we can see the project environments (development, staging, uat and prod).
Notes are especially interesting, you author them in markdown syntax. They can be tied to a server or a project.
And full-text search is supported.
The application also supports gtk's dark mode:
There was some effort made to make the GUI application as keyboard-friendly as possible.
## Command-line application
The command-line application loads all commands, servers, and files of interest, and displays them in a flat list, that you filter by typing and navigate using arrow keys. The application can execute commands, log you on ssh servers, edit configuration files, tail log files or fetch them, and so on.
Here is the display of ppcli after startup, showing a list of possible actions (the action themselves are described in the last column):
And in the next screenshot, the user typed 'sra fail' and therefore filtered the rows to display only only application servers (SRA) and matched 'fail' on the line, which matched the failover server.
Normally you would type keywords (part of the project name, of the environment, of the item type), until the list is filtered to contain a few or a single element, at which you point you can just press enter to run the command.
You can launch `ppcli` manually, or you can use its zsh integration: `ppcli --print-shell-function zsh >> ~/.zshrc`, and reload the shell. After doing that, and if `ppcli` is in the path, you can launch it using `control+space`, and any command you run through ppcli will be added to your CLI history.
Note that even though you can enter ssh passwords in projectpad, no effort is made to hand them to ssh when logging in through ppcli. The recommended way to login to ssh servers without password is through ssh keys, but regardless password management remains valuable.
[sqlcipher]: https://www.zetetic.net/sqlcipher/
## Installation
The recommended way to install the applications is with flatpak for the projectpad GUI, and as a statically built linux binary for ppcli. You can download the ppcli static binary, that can auto-upgrade later, from [the github downloads](https://github.com/emmanueltouzery/projectpad2/releases) -the binary is one of the release assets-, and the flatpak from [flathub](https://flathub.org/apps/details/com.github.emmanueltouzery.projectpad).
It's possible to share the projectpad database between computers using Dropbox or similar services. The database is a single file, you can find its location in the preferences dialog of the GUI application. It's possible to use symbolic links to make the database location point anywhere (for instance to the Dropbox directory), but if you use flatpak,
you must grant the application access to the folder where the DB is stored, through a command like `flatpak override com.github.emmanueltouzery.projectpad --filesystem=~/Dropbox/projectpad/ --user`.
Installation on OSX has not been attempted, it should work if you [install the rust compiler toolchain](https://rustup.rs/), gtk+3, gtksourceview3 and adwaita-icon-theme on homebrew, and the sqlcipher library with development headers. You could then run `cargo run --release --bin projectpad` and `cargo run --release --bin ppcli` in a git checkout. The binaries will be in `target/release` and are relocatable.