Skip to content

connectbot/connectbot

Repository files navigation

Build Status

ConnectBot

ConnectBot is a Secure Shell client for Android that lets you connect to remote servers over a cryptographically secure link.

Google Play

Get it on Google Play

Compiling

Android Studio

ConnectBot is most easily developed in Android 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:

./gradlew build

Continuous Integration

ConnectBot uses GitHub 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. This requires Docker to be installed and running.

To run the main CI workflow (ci.yml):

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