Download

Simple Social is available on the web, on your phone, and in your terminal. All of them use the same account, so you can sign in anywhere.

iOS & Android

Add Simple Social to your home screen. It opens full-screen, without the browser's address bar, just like an app from the app store.

If the button doesn't do anything, install it manually instead:

  • Android, Chrome, Edge: open the browser's menu (usually ⋮ or ☰) and tap Install app or Add to Home Screen.
  • iPhone or iPad (Safari): tap the Share icon, then Add to Home Screen.

Desktop

Installation instructions are coming soon.

CLI

A command-line client for scripting and quick one-off commands. Builds from source on Debian and Ubuntu only for now (Arch and Nix support is coming soon).

1. Install the build tools:

sudo apt update && sudo apt install -y build-essential

2. Clone the repo:

git clone https://github.com/DavidFruin/simple-social-cli.git

3. Build it:

cd simple-social-cli && make

Then run it with ./simple-social-cli --help from inside that folder.

The build needs libcurl, which is almost always already installed on Debian/Ubuntu. If make fails with a curl-related error, run sudo apt install -y libcurl4t64 (newer systems) or sudo apt install -y libcurl4 (older systems), then run make again.

Interactive CLI

A guided command-line client that prompts you for each step. It's a separate program that uses the CLI above, so build the CLI first, then run these from the same folder you ran the CLI's git clone in (not inside the simple-social-cli folder). Debian and Ubuntu only for now, same as the CLI.

1. Clone the repo:

git clone https://github.com/DavidFruin/simple-social-cli-interactive.git

2. Build it:

cd simple-social-cli-interactive && make

Then run it with ./simple-social-cli-interactive from inside that folder.

TUI

A full-screen terminal interface you navigate with the keyboard. It's a separate program that uses the CLI above, so build the CLI first, then run these from the same folder you ran the CLI's git clone in (not inside the simple-social-cli folder). Debian and Ubuntu only for now, same as the CLI.

1. Install ncurses:

sudo apt update && sudo apt install -y libncurses-dev

2. Clone the repo:

git clone https://github.com/DavidFruin/simple-social-tui.git

3. Build it:

cd simple-social-tui && make

Then run it with ./simple-social-tui from inside that folder. If you're already logged in from the CLI or Interactive CLI, it opens straight to your feed — all three tools share the same session. Otherwise you'll land on a login screen where you can log in, register, or reset a forgotten password.