Miami Cruise

Miami Cruise / Apps / btop

btop

A calm system dashboard with readable graphs and magenta focus.

btop dashboard with the dark theme and a selected demo process
btop dashboard with the dark theme and a selected demo process
btop dashboard with the light theme and a selected demo process
btop dashboard with the light theme and a selected demo process

Install

  1. Download

    Download miami-cruise-dark.theme and miami-cruise-light.theme. Then open a terminal in the folder where they were saved (usually Downloads).

    These are native .theme files, not btop.conf replacements. They only define colours; your monitoring settings and layout stay unchanged.

    curl -fsSLO https://lanjelin.github.io/miami-cruise/downloads/btop/miami-cruise-dark.theme
    curl -fsSLO https://lanjelin.github.io/miami-cruise/downloads/btop/miami-cruise-light.theme
  2. Install the native theme files

    Install btop first. Copy the two theme files into your btop themes directory. This does not replace your existing btop.conf. If you previously customized files with the same names, keep a backup before replacing those files.

    Linux / macOS
    btop_dir="${XDG_CONFIG_HOME:-$HOME/.config}/btop"
    mkdir -p "$btop_dir/themes"
    cp miami-cruise-dark.theme miami-cruise-light.theme "$btop_dir/themes/"
    btop

    Inside btop, press Esc to open the menu, choose Options, then select miami-cruise-dark or miami-cruise-light under Color theme. btop saves the selection on exit. There is no automatic dark/light switching in these theme files.

  3. Use your terminal background without replacing your config

    Enable Truecolor and disable Theme background in Options to let your terminal background show through. If editing your existing btop.conf while btop is closed, update these existing keys rather than appending duplicate settings:

    color_theme = "miami-cruise-dark"
    truecolor = true
    theme_background = false

    With theme_background = false, btop uses your terminal background; use a matching terminal theme. Set it to true if you prefer the exact Miami Cruise background. --low-color quantizes RGB to 256 colours. TTY mode forces btop's built-in 16-colour TTY theme, so it cannot show the full palette. Process colour/gradient settings also affect how the colour ramps appear.

    If you use a nonstandard theme folder or launch btop with a custom --config file, pass an explicit theme directory. These options are supported by the tested btop 1.4.8:

    Linux / macOS
    btop --themes-dir /absolute/path/to/themes
    # With your own config file:
    btop --config /absolute/path/to/btop.conf --themes-dir /absolute/path/to/themes

    To uninstall, select another theme in Options and exit btop, then remove the two Miami Cruise theme files. Other btop settings are left intact.

    This port targets btop on Linux/macOS. Windows btop4win and bpytop/bashtop have not been tested. GPU-specific monitoring is hardware-dependent and was not available during testing. Native theme reference: https://github.com/aristocratos/btop#themes

Install with an agent

Paste this prompt into an agent with web access and access to the machine where your apps run. No cloning, building or manual file downloads needed.

Agent prompt
Help me install Miami Cruise. Read
https://raw.githubusercontent.com/lanjelin/miami-cruise/main/INSTALL.md
and follow its linked playbooks. Inspect and propose installation for btop only; ask which variant I want.
Download the selected files yourself from the project website or a pinned GitHub revision. Propose exact changes and wait for my approval before making changes. Include private backups and conflict-aware restoration instructions and scripts before applying changes.

The agent inspects first and asks for approval. If it cannot access your machine, it can provide tailored commands instead. Read the installation and restoration guide.