README ¶
Keybase
Hi, and welcome to the Keybase client repo. All our client apps (macOS, Windows, Linux, iOS, and Android) are being actively developed in this repository. Please, dig around.
Warnings
We'd love you to read our source code.
But - some of the things in this repo are explorations, and the app you build from source just might not do what it says it's doing. So, if you just want to install Keybase on your computer, you should monitor our releases for macOS, Linux, or Windows.
Code Layout
- go: Core crypto libraries; the Keybase service; the command line client. Learn More
- shared/react-native: Android and iOS apps developed with React Native.
- shared/desktop: Desktop application for macOS, Linux, and Windows, made with the Electron framework, sharing React code with react-native.
- packaging: Scripts for releasing packages across the various platforms.
- protocol: Defines the protocol for communication for clients to the Keybase services. Uses Avro. Learn More
- media: Icons, graphics, media for Keybase apps.
- osx: The macOS Keybase.app, development parallel to an Electron-based application above. Learn More
Problems?
Report any issues with client software on this GitHub issue tracker. Internally, we track our progress using Jira, but all PRs come through GitHub for your review!
If you're having problems with the command line keybase
client, take a
look at the troubleshooting doc.
If you're having problems with our Website, try the keybase-issues issue tracker.
We check and update both frequently.
License
Most code is released under the New BSD (3 Clause) License. If subdirectories include a different license, that license applies instead.
Development Guidelines
We check all git commits with pre-commit hooks generated via pre-commit.com pre-commit hooks. To enable use of these pre-commit hooks:
- Install the
pre-commit
utility. For some common cases:pip install pre-commit
brew install pre-commit
- Remove any existing pre-commit hooks via
rm .git/hooks/pre-commit
- Configure via
pre-commit install
Then proceed as normal.
External Contributors
If you forked this repository on GitHub and made a PR, then it'll show up as having failed Jenkins CI. We do not build external PRs because it's a security risk to do so without a review first. If your PR is successfully reviewed by a member of the Keybase team, then we will merge your commits to a branch on our primary fork and build from there.
Cryptography Notice
This distribution includes cryptographic software. The country in which you currently reside may have restrictions on the import, possession, use, and/or re-export to another country, of encryption software. BEFORE using any encryption software, please check your country's laws, regulations and policies concerning the import, possession, or use, and re-export of encryption software, to see if this is permitted. See http://www.wassenaar.org/ for more information.
The U.S. Government Department of Commerce, Bureau of Industry and Security (BIS), has classified this software as Export Commodity Control Number (ECCN) 5D002.C.1, which includes information security software using or performing cryptographic functions with asymmetric algorithms. The form and manner of this distribution makes it eligible for export under the License Exception ENC Technology Software Unrestricted (TSU) exception (see the BIS Export Administration Regulations, Section 740.13) for both object code and source code.
Directories ¶
Path | Synopsis |
---|---|
go
|
|
auth
Code used to support authentication tokens for arbitrary purposes.
|
Code used to support authentication tokens for arbitrary purposes. |
client
this command is only for testing purposes this is the list of commands for all versions of the client.
|
this command is only for testing purposes this is the list of commands for all versions of the client. |
engine
This engine enters a user into the reset pipeline.
|
This engine enters a user into the reset pipeline. |
kbfs/dokan
Package dokan binds to the Dokan Windows filesystem library (similar to fuse).
|
Package dokan binds to the Dokan Windows filesystem library (similar to fuse). |
kbfs/dokan/winacl
Package winacl adds support for various Windows security APIs for Dokan.
|
Package winacl adds support for various Windows security APIs for Dokan. |
kbfs/libdokan
Package libdokan is an interface between libkbfs and dokan.
|
Package libdokan is an interface between libkbfs and dokan. |
kbfs/test
Package test is a test framework for KBFS
|
Package test is a test framework for KBFS |
minterm
Package minterm implements minimal terminal functions.
|
Package minterm implements minimal terminal functions. |
stellar/stellarsvc
this file is for the implementation of all the frontend-requested service endpoints for wallets.
|
this file is for the implementation of all the frontend-requested service endpoints for wallets. |
teams
Similar to libkb/kbsigs.go, but for teams sigs.
|
Similar to libkb/kbsigs.go, but for teams sigs. |