Files
MacPass/README.md
2018-04-04 11:22:38 +02:00

196 lines
8.3 KiB
Markdown

[![Build Status](https://travis-ci.org/mstarke/MacPass.svg?branch=continuous)](https://travis-ci.org/mstarke/MacPass)
# MacPass
There are a lot of iOS KeePass tools around but a distinct lack of a good native macOS version.
KeePass can be used via Mono on macOS but lacks vital functionality and feels sluggish and simply out of place.
MacPass is an attempt to create a native macOS port of KeePass on a solid open source foundation with a vibrant community pushing it further to become the best KeePass client for macOS.
## Download
All pre-built releases can be found at [Github](https://github.com/mstarke/MacPass/releases).
An unsigned build of the current contiuous tag can be found here: [Continuous Build](https://github.com/mstarke/MacPass/releases/tag/continuous)
Due to the nature of the build it might be unstable, however this version contains all the latest changes and bug fixes!
## How to Contribute
If you want to contribute by fixing a bug, adding a feature or improving localization you're awesome!
## How to Build
* Fetch the source of MacPass
```bash
git clone https://github.com/mstarke/MacPass --recursive
```
* Install [Carthage](https://github.com/Carthage/Carthage#installing-carthage)
* Install all Dependencies
```bash
cd MacPass
carthage bootstrap --platform macOS
```
After that you can build and run in Xcode. The following command will build and make the application available through Spotlight. If you run into signing issues take a look at [Issue #92](https://github.com/mstarke/MacPass/issues/92). Since Sparkle is disabled only on the CI build and in Debug mode, you have to explicitly disable it in Release. Otherwise warnings on unsecure updates will appear.
xcodebuild -scheme MacPass -target MacPass -configuration Release CODE_SIGNING_REQUIRED=NO NO_SPARKLE=NO_SPARKLE
## Help
Some questions might be ansered in the [FAQ](https://github.com/mstarke/MacPass/wiki/FAQ)
Another place to look is the IRC channel [#macpass](irc://irc.freenode.org/macpass) on [irc.freenode.org](irc://irc.freenode.org)
Or follow the Twitter account [@MacPassApp](https://twitter.com/MacPassApp)
## System Requirement
MacPass 0.7 requires macOS 10.10 Yosemite or later.
Earlier versions of MacPass require macOS 10.8 Mountain Lion or later.
## Status
The Status can be found on the dedicated [Wiki page](https://github.com/mstarke/MacPass/wiki/Status).
## What does it look like?
![image](https://raw.github.com/mstarke/MacPass/master/Assets/Screenshots/MacPass.png)
More Screenshots in the [Wiki](https://github.com/mstarke/MacPass/wiki/Screenshots)
## Alternatives
[KeePassX](https://www.keepassx.org) and it's fork [KeePassXC](https://github.com/keepassxreboot/keepassxc). Qt based cross plattform port.
[KyPass Companion](http://www.kyuran.be/logiciels/kypass4mac/). Native macOS client.
[KeeWeb](https://keeweb.info). Electron based cross plattform port. Since it's browser based you can pretty much run it anywhere.
## License
MacPass, a KeePass compatible Password Manager for OS X
Copyright (c) 2012-2017 Michael Starke (HicknHack Software GmbH) and all [MacPass contributors](https://github.com/mstarke/MacPass/graphs/contributors)
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.
## App Store
Due to being licensed under GPLv3 it's not possible to publish a version of MacPass on the App Store.
For further details, take a look at the [explanation](https://www.fsf.org/news/2010-05-app-store-compliance) of the Free Software Foundation.
## Contributions
The following list might not be complete, please refer to [merged Pull Requests](https://github.com/mstarke/MacPass/pulls?utf8=✓&q=is%3Apr+is%3Aclosed+is%3Amerged) on GitHub for more details. Please open an issue if you think someone is missing from this list!
### Art
[Iiro Jäppinen](https://iiro.jappinen.me) MacPass icon
[Thom Williams](https://github.com/thomscode) Document icons
[Joanna Olsen](https://github.com/JoannaOlsen) Database Icons
### Contributors
[ad](github.mnms@mamber.net)
[Alex Borisov](alex@alexborisov.org)
[Alex Seeholzer](seeholzer@gmail.com)
[amd](amd@gurge.com)
[Andrew Schleifer](me@andrewschleifer.name)
[AntoineCa](antoine@carrincazeaux.fr)
[Benjamin Steinwender](b@stbe.at)
[binarious](bieder.martin@googlemail.com)
[Carlos Filipe Simões](ravemir@users.noreply.github.com)
[Chester Liu](skyline75489@outlook.com)
[Chhom Seng](chhom.seng@gmail.com)
[Christoph Leimbrock](christoph.leimbrock@gmx.de)
[Cory Hutchison](cjhutchi@users.noreply.github.com)
[Daniele Polencic](daniele.polencic@gmail.com)
[darnel](vojta.j@gmail.com)
[Deiwin Sarjas](deiwin.sarjas@gmail.com)
[Dennis Bolio](git@bolio.nl)
[Dylan Smith](dylansmith@gmail.com)
[Filipe Farinha](filipe@ktorn.com)
[floriangouy](florian.gouy@gmail.com)
[Francesco Servida](info@francescoservida.ch)
[Frank Enderle](frank.enderle@anamica.de)
[Gaétan Ryckeboer](gryckeboer@jouve.com)
[Geigi](git@geigi.de)
[James Hurst](jamesrhurst@outlook.com)
[Jannick Hemelhof](mister.jannick@gmail.com)
[Jefftree](jeffrey.ying86@live.com)
[Jellyfrog](Jellyfrog@users.noreply.github.com)
[Joanna Olsen](jo4flash@gmail.com)
[Josh Halstead](jhalstead85@gmail.com)
[Kurt](kurt@soapbox-software.com)
[Lenucksi](lenucksi@users.noreply.github.com)
[Leonardo Faoro](lfaoro@users.noreply.github.com)
[Liam Anderson](liam.anderson.91@gmail.com)
[Maarten Terpstra](m.l.terpstra@student.rug.nl)
[Mario Sangiorgio](mariosangiorgio@gmail.com)
[MBibal](michel.bibal@gmail.com)
[Michael Belz](mbelz@outlook.de)
[Michal Jaglewicz](michalj@webii.pl)
[Moises Perez](moises@perez.lt)
[mrdoggy](mrdoggy.all@gmail.com)
[Nathan Landis](nathanlandis@gmail.com)
[Nathaniel Madura](nmadura@umich.edu)
[neuroine](d.dzieduch@gmail.com)
[Patrik Thunström](magebarf@gmail.com)
[rdoering](rdoering.info@gmail.com)
[Ryan Rogers](ryan@timewasted.me)
[Sitsofe Wheeler](sitsofe@yahoo.com)
[Stephen Taylor](schtee.taylor@gmail.com)
[Thom](thomscode@gmail.com)
[Thorsten Jacoby](tjacoby@gmail.com)
[Volcyy](Volcyy@users.noreply.github.com)
[Yonatan Mittlefehldt](yono@toojuice.com)
[Zero King](l2dy@icloud.com)
[Zhao Peng](patchao2000@gmail.com)
## Copyright
This Project is based upon the following work:
[KeePassKit](https://github.com/mstarke/KeePassKit) Copyright 2012 HicknHack Software GmbH. All rights reserved.
[HNHUi](https://github.com/mstarke/HNHUi) Copyright 2012 HicknHack Software GmbH. All rights reserved.
[MiniKeePass](https://github.com/MiniKeePass/MiniKeePass) Copyright 2011 Jason Rush and John Flanagan. All rights reserved.
[KeePass Database Library](https://github.com/mpowrie/KeePassLib) Copyright 2010 Qiang Yu. All rights reserved.
[PXSourceList](https://github.com/Perspx/PXSourceList) Copyright 2011, Alex Rozanski. All rights reserved.
[KSPasswordField](https://github.com/karelia/SecurityInterface) Copyright 2012 Mike Abdullah, Karelia Software. All rights reserved.
[DDHotKey](https://github.com/davedelong/DDHotKey) Copyright [Dave DeLong](http://www.davedelong.com). All rights reserved.
[Sparkle](http://sparkle.andymatuschak.org) Copyright 2006 Andy Matuschak
[TransformerKit](https://github.com/mattt/TransformerKit) Licensed under MIT license. Copyright 2012 [Mattt Thompson](http://mattt.me/). All rights reserved
[MJGFoundation](https://github.com/mstarke/MJGFoundation) Licensed under BSD 2-Clause License. Copyright 2011 [Matt Galloway](http://www.galloway.me.uk/). All rights reserved.
[ShortcutRecorder](http://wafflesoftware.net/shortcut/) Copyright 2006—2013 all [Shortcut Recorder contributors](http://wafflesoftware.net/shortcut/contributors/)
[NSBundle Codesignature Check](http://jedda.me/2012/03/verifying-plugin-bundles-using-code-signing/) Copyright 2014 [Jedda Wignall](http://jedda.me). All rights reserved.
See submodules for additional Licenses
## Feedback
[![Flattr this](https://api.flattr.com/button/flattr-badge-large.png)](https://flattr.com/thing/1550529/mstarkeMacPass-on-GitHub)