Skip to content
This repository has been archived by the owner on Nov 29, 2023. It is now read-only.

deadbaed/pass4thewin

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

pass4thewin

pass for the windows platform

Quick (and dirty) clone of pass written in Rust for Windows. It should be compatible with pass (but no guarantees)

Recommends git to be installed for syncing with git remotes, but it is not required.

If you know a bit of ssh keys, gpg, OpenPGP and git you should be alright.

Install

for 64 bit only

Once you've downloaded your pass4thewin.exe, place it in a folder in your PATH.

You should be able to run pass4thewin in a terminal!

First run

To start using pass4thewin you need to have the PGP secret key you use for your password store in a file.

Most users (I think) will be coming from linux, if you are and do not know how to export a PGP secret key you can read this documentation to learn.

Please place your private key in a location that will always be available, since it is required to decrypt passwords.

Run pass4thewin init <private-key-path> to create or detect a password store. By default this will look in the path c:\users\username\.password-store, where username is your Windows username.

If you do not know how to get your <private-key-path>, find your private key in the file explorer, hold the Shift key and right click on the file and select the option Copy as path: Screenshot of the Copy as path option in the windows explorer on a file

Run pass4thewin init --help to find all the options of the init command.

Development

Tools required: rust and cargo. You can use rustup to install them.

Run cargo build to compile and cargo run to run the binary.

Config file

A config file is used to store:

  • the path of the password store
  • the path of the pgp key used

When starting, pass4thewin looks for a config file in these 2 locations (in order):

  1. In the current path of the binary (run command Get-Command pass4thewin to know where)
  2. In %USERPROFILE%\AppData\Roaming\philippeloctaux\pass4thewin\config (The user's Roaming folder)

pass4thewin can not function without a valid config file. See First run to generate one.