FirstPass

The best Password Manager in the World!

FirstPass is designed to allow users to store their passwords securely and easily. Among other things, we offer a password generator that automatically generates secure passwords. This is seamlessly integrated into the manager and can be configured as desired. But not only username and password can be stored: It is also possible to save a URL to the website to access it more easily. It is also possible to leave a note, which is of course also encrypted. The security of the data has the highest priority for us!

• Features
• Installation
  • Windows
  • Mac
  • Linux
• Usage
• Build from Source
• Contributing
• Copyright

Attention!

No Security Audit was accomplished. Please do not use Firstpass as your real world password manager.

Features

• Encrypted storage of passwords using AES-256 encryption
• Automatically generates strong passwords
• Ability to store and manage passwords for multiple accounts and websites
• Cross-platform compatibility (Windows, Mac, Linux)
• User-friendly interface including customizable Themes

Installation

To install the password manager, follow the instructions for your platform.
Make sure you have the Java 17 JRE installed.

Windows

1. Download the Firstpass Setup X.X.X.exe file from the releases page.
2. Double-click the file to start the installation process.
3. Follow the on-screen instructions to complete the installation.

Mac

1. Download the Firstpass-X.X.X.dmg file from the releases page.
2. Run the file to start the installation process.
3. Follow the on-screen instructions to complete the installation.

Linux

1. Download the Firstpass-X.X.X.AppImage file from the releases page.
2. You may need to run chmod +x Firstpass-X.X.X.AppImage.
3. Run the file: ./Firstpass-X.X.X.AppImage

Archive Install

For every platform we also provide an archive containing all program files. To install using an archive, download the right one for your platform:

• Windows: Firstpass-X.X.X-win.zip
• Mac: Firstpass-X.X.X-mac.tar.gz
• Linux: Firstpass-X.X.X.tar.gz

After downloading the archive, extract it to a folder of your choice. Then, run the Firstpass executable inside.

Usage

• Start the password manager and create a new database or log in to an existing database.
• Add a new password by clicking the "Add" button and entering the required information.
• Add, edit or delete a category by clicking the three buttons at the top of the sidebar
• You can also generate a strong password by clicking the button next to the password input field
• To update, delete or show a password, just click on its entry in the password list
• To move a password in a different category, just drag and drop it
• To add a new Theme, go to the settings menu and clone an existing Theme or load a JSON-File in the right format

Build from source

In order to build FirstPass from source you need to have NodeJS, Java 17 & Maven, npm & yarn.
To build, navigate to the project directory and run:

npm run dist    # builds backend, frontend and packages the app

Note: On Mac, you need to run export CSC_IDENTITY_AUTO_DISCOVERY=false first, to prevent the build from trying to do code signing.
This will build the backend and the frontend and package it into a distributable package for you platform.
The output will be in the dist folder.

Troubleshooting

In case you encounter any problems, feel free to contact us via email or open an issue on GitHub.

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change. Please make sure to update tests accordingly.

Copyright

FirstPass (c) 2023 Alexander Bossert, Antonia Herdtner, Leonard Laisé, Luca von Kannen, Maurice Dolibois, Michael Dick, Tom Flocken
SPDX-License-Identifier: GPL-3.0