Osiris Password Manager
Table of Contents
- About the Project
- Getting Started
About The Project
To get a local copy up and running follow these simple steps.
- linux or windows (available for macOS only with Docker)
Debian and Ubuntu-based
# go to Releases and download the deb package # install the deb package sudo apt install ./Osiris-pwm1.0.deb
Any other Linux distribution
# select where to download the program, for example here I download it to the Desktop cd Desktop # clone and go into repo git clone https://github.com/Gyro7/Osiris-pwm.git cd Osiris-pwm/ # change mod chmod +x Osiris-pwm # run ./Osiris-pwm
Any other Linux distribution (Releases method)
# go to Releases and download the .zip file # decompress it unzip -q Osiris-pwm1.0.zip # go into the directory cd Osiris-pwm # change mod chmod +x Osiris-pwm # run ./Osiris-pwm
Any other Linux distribution (Build from source)
For this method you need to have Go installed, build-essential and a few dependencies (even tho they should be downloaded automatically)
If you encounter any problems in installing dependencies, follow this guide: https://github.com/go-gl/glfw
# clone and go into repo git clone https://github.com/Gyro7/Osiris-pwm.git cd Osiris-pwm/ # remove the linux executable rm Osiris-pwm # build go build # run ./Osiris-pwm
Go to Releases and download the setup for Windows (.exe file) Follow the simple steps IF THE PROGRAM DOESN'T WORK, RIGHT CLICK ON IT, GO TO PROPERTIES, GO TO COMPATIBILITY AND SELECT "ALWAYS EXECUTE AS ADMINISTRATOR"
If you followed the previous steps, you just have to run the program. To add a new element to the grid click the white add button on the middle left. To delete an element, edit it so that all its entries are empty, then head to the Edit menu and click "Delete empties" To change theme go to File -> Settings
A build script is provided for easy building. Docker is the only dependency.
Using Docker has the following benefits:
- Build Linux packages on Mac and Windows
- Builds are consistent, always built the same way
- Does not require the build chain to be installed on your workstation
Built artifacts will be in
build/artifacts/ when the build is complete
ls build/artifacts Osiris-pwm Osiris-pwm_linux_amd64.zip Osiris-pwm.SHA256SUMS
Local build tools
If Docker is not an option, or you prefer to build in your own environment, you will need the following installed:
- Go toolchain
- A C compiler (GCC), this project uses CGO
- Debian: build-essential
- Fedora: @development-tools
- This project uses go-gl, which has its own build requirements
See the open issues for a list of proposed features (and known issues).
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature)
- Commit your Changes (
git commit -m 'Add some AmazingFeature')
- Push to the Branch (
git push origin feature/AmazingFeature)
- Open a Pull Request
Distributed under the MIT License. See
LICENSE for more information.