tweety

README

Tweety - An Integrated Terminal for your Browser

Minimize your context switching by interacting with your terminal directly from your browser.

Features

Mix Web and Terminal tabs

Side by side mode

Developer-Console Integration

Installation

Tweety is available on macOS, Linux.

# Homebrew (recommended)
brew install pomdtr/tap/tweety

# From source
go install github.com/pomdtr/tweety@latest

or download a binary from releases.

See the tweety completion command to generate completion scripts for your shell.

Usage

tweety [-p <port>]

By default, tweety will start on port 9999, so you can access it at http://localhost:9999.

If you prefer to use a browser friendly URL, you can go to https://tweety.sh instead. The page will access Tweety on port 9999.

Note: Browser Friendly urls are not available on Safari, and requires to disable the Shield feature on Brave.

Chrome Extension

A chrome extension is availaible in the extension folder. To install it:

• Clone the repository
• Go to chrome://extensions
• Enable Developer mode
• Click on Load unpacked
• Select the extension folder

By default, the extension will try to connect to localhost:9999. You can customize the origin in the extension options.

Starting Tweety on boot

If you have installed Tweety using Homebrew, you can use the following command:

brew services start tweety

To unload the service, use:

brew services stop tweety

Configuration

Use the $XDG_CONFIG_DIR/tweety/tweety.json file to configure Tweety (defaults to ~/.config/tweety/tweety.json).

Alternatively, you can use the TWEETY_CONFIG environment variable to specify a custom path.

{
  "$schema": "https://github.com/pomdtr/tweety/releases/latest/download/config.schema.json",
  "theme": "Tomorrow",
  "themeDark": "Tomorrow Night",
  "env": {
    "EDITOR": "kak"
  },
  "defaultProfile": "default",
  "profiles": {
    "default": {
      "command": "bash",
      "args": ["--login"],
      "env": {
        "EDITOR": "vim"
      }
    },
    "fish": {
      "command": "fish",
      "args": ["--login"],
      "favicon": "https://fishshell.com/favicon.ico"
    }
  }
}

Endpoints

• / - open the default profile
• /?reload=true - reload the page when the command exits
• /?profile=<profile> - open a specific profile

FAQ

Firefox version?

Firefox should be quite easy to support, the browser integration is minimal. Contributions are welcome!

Windows version?

The library used to create the terminal UI (xterm.js) does not support Windows yet. But it's planned, so stay tuned!