An open API service indexing awesome lists of open source software.

https://github.com/katzer/alpinepass

Exports the Orbit KDB into various file formats.
https://github.com/katzer/alpinepass

cli keepass-converter mruby-cli orbit

Last synced: 11 months ago
JSON representation

Exports the Orbit KDB into various file formats.

Awesome Lists containing this project

README

          

# alpinepass
[![GitHub release](https://img.shields.io/github/release/katzer/alpinepass.svg)](https://github.com/katzer/alpinepass/releases) [![Build Status](https://travis-ci.com/katzer/alpinepass.svg?branch=master)](https://travis-ci.com/katzer/alpinepass) [![Build status](https://ci.appveyor.com/api/projects/status/76ytl3ycyqs0va8j/branch/master?svg=true)](https://ci.appveyor.com/project/katzer/alpinepass/branch/master) [![Maintainability](https://api.codeclimate.com/v1/badges/f5d906346be0d06ae4fc/maintainability)](https://codeclimate.com/github/katzer/alpinepass/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][releases] 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][keepass] 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][license].

Made with :heart: in Leipzig

© 2017 [appPlant GmbH][appplant]

[releases]: https://github.com/katzer/alpinepass/releases
[keepass]: https://keepass.info/help/v2_dev/scr_sc_index.html#export
[license]: http://opensource.org/licenses/Apache-2.0
[appplant]: www.appplant.de