Skip to content

katzer/alpinepass

Repository files navigation

alpinepass
GitHub release Build Status Build status Maintainability

The tool that exports your Orbit KeePass database into various file formats.

$ alpinepass -h

Usage: alpinepass [options...] -i input_file [-o output_file] matchers...
Options:
-i, --input     Path to the input file
-o, --output    Path to the output file
-f, --format    Format of the output file
                Defaults to: fifa
-c, --check     Check the content of the input file
-p, --pretty    Pretty print output
-s, --secrets   Export secrets like passwords
-h, --help      This help text
-v, --version   Show version number

Installation

Download the latest version from the release page and add the executable to your PATH.

Usage

Transform the KeePass file by using the $ORBIT_HOME/config/orbit.xsl stylesheet:

KPScript -c:Export "%ORBIT_HOME%\config\orbit.kdbx" -pw:MyPw -Format:"Transform using XSL Stylesheet" -XslFile:"%ORBIT_HOME%\config\orbit.xsl" -OutFile:"%ORBIT_HOME%\config\orbit.export"

Then convert the exported data into a valid knowledge database for fifa:

$ alpinepass -i keepass.export -f fifa -o orbit.json

To create a knowledge database for fifa containing production databases only:

$ alpinepass -i keepass.export -f fifa -o orbit.json type=db@env=prod

Note: See here for how to use KPScript with single command operations to perform simple database operations. Of course you can also use the GUI to perform the export.

Development

Clone the repo:

$ git clone https://github.com/katzer/alpinepass.git && cd alpinepass/

Install the dependencies:

$ bundle

And then execute:

$ rake compile

To compile the sources locally for the host machine only:

$ MRUBY_CLI_LOCAL=1 rake compile

You'll be able to find the binaries in the following directories:

  • Linux (AMD64, Musl): build/x86_64-alpine-linux-musl/bin/alpinepass
  • Linux (AMD64, GNU): build/x86_64-pc-linux-gnu/bin/alpinepass
  • Linux (AMD64, for old distros): build/x86_64-pc-linux-gnu-glibc-2.9/bin/alpinepass
  • OS X (AMD64): build/x86_64-apple-darwin19/bin/alpinepass
  • OS X (ARM64): build/arm64-apple-darwin19/bin/alpinepass
  • Windows (AMD64): build/x86_64-w64-mingw32/bin/alpinepass
  • Host: build/host/bin/alpinepass

For the complete list of build tasks:

$ rake -T

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/katzer/alpinepass.

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request

License

The code is available as open source under the terms of the Apache 2.0 License.

Made with ❤️ in Leipzig

© 2017 appPlant GmbH