https://github.com/connectbot/connectbot
ConnectBot is the first SSH client for Android.
https://github.com/connectbot/connectbot
android connectbot java ssh ssh-client ssh2
Last synced: 17 days ago
JSON representation
ConnectBot is the first SSH client for Android.
- Host: GitHub
- URL: https://github.com/connectbot/connectbot
- Owner: connectbot
- License: apache-2.0
- Created: 2009-02-06T17:52:35.000Z (almost 17 years ago)
- Default Branch: main
- Last Pushed: 2025-05-09T06:39:04.000Z (8 months ago)
- Last Synced: 2025-05-09T07:41:32.355Z (8 months ago)
- Topics: android, connectbot, java, ssh, ssh-client, ssh2
- Language: Java
- Homepage: https://connectbot.org
- Size: 8.23 MB
- Stars: 2,660
- Watchers: 124
- Forks: 643
- Open Issues: 356
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/connectbot/connectbot/actions/workflows/ci.yml)
# ConnectBot
ConnectBot is a [Secure Shell](https://en.wikipedia.org/wiki/Secure_Shell)
client for Android that lets you connect to remote servers over a
cryptographically secure link.
## How to Install
### Google Play
[![Get it on Google Play][2]][1]
[1]: https://play.google.com/store/apps/details?id=org.connectbot
[2]: https://developer.android.com/images/brand/en_generic_rgb_wo_60.png
The easiest way to get ConnectBot is to [install from Google Play Store][1].
If you have installed from a downloaded APK, Google Play Store can upgrade
your installed version to the latest version. However, once it has upgraded
*you can't install a version from the releases on GitHub anymore.*
### Download a release
ConnectBot can be downloaded from [releases](
https://github.com/connectbot/connectbot/releases) on GitHub. There are
two versions:
- "`google`" — for a version that uses Google Play Services
to handle upgrading the cryptography provider
- "`oss`" — includes the cryptography provider in the APK which
increases its size by a few megabytes.
## Compiling
### Android Studio
ConnectBot is most easily developed in [Android Studio](
https://developer.android.com/studio/). You can import this project
directly from its project creation screen by importing from the GitHub URL.
### Command line
To compile ConnectBot using `gradlew`, you must first specify where your
Android SDK is via the `ANDROID_SDK_HOME` environment variable. Then
you can invoke the Gradle wrapper to build:
```sh
./gradlew build
```
### Continuous Integration
ConnectBot uses [GitHub Actions](https://github.com/connectbot/connectbot/actions)
for continuous integration. The workflow is defined in
`.github/workflows/ci.yml`.
#### Running Workflows Locally with act
In general, simply running `./gradlew build` should cover all the
checks run in the GitHub Actions continuous integration workflow, but you can
run GitHub Actions workflows locally using [`nektos/act`](https://github.com/nektos/act).
This requires Docker to be installed and running.
To run the main CI workflow (`ci.yml`):
```sh
act -W .github/workflows/ci.yml
```
## Translations
If you'd like to correct or contribute new translations to ConnectBot,
then head on over to [ConnectBot's translations project](
https://translations.launchpad.net/connectbot/trunk/+pots/fortune)