id       = "oh-my-tmux"
name     = "Oh my tmux!"
homepage = "https://github.com/gpakosz/.tmux"
description = "A self-contained, pretty and versatile tmux configuration."
# The repository's own description, trimmed of its first-person framing.

# The project's own logomark, from the .logo directory in its repository
# (the file beside it pairs the mark with a wordmark and is too wide here).
icon     = "https://raw.githubusercontent.com/gpakosz/.tmux/master/.logo/logomark.svg"

# Oh my tmux! defines no command and has no bundle identifier: it is a tmux
# configuration a user installs. The entry is filed and detected under the
# project's name, the way janus and the other framework entries here are.
# Deliberately not `tmux`: that maps to tmux's own entry, whose ~/.tmux.conf is
# the file this project replaces with its own.
executables   = ["oh-my-tmux"]
platforms = ["macos", "linux"]

[dotfiles]

# README: "you should never alter the main .tmux.conf or tmux.conf file. If you
# do, you're on your own. Instead, every customization should happen in your
# .tmux.conf.local or tmux.conf.local customization file copy." Which of the
# two names applies depends on where the setup was installed — the README
# supports `~`, `$XDG_CONFIG_HOME/tmux` and `~/.config/tmux`, and the files
# under a config directory drop the leading dot. Both spellings are listed so a
# consumer picks up whichever exists; the XDG one reads the variable, hence
# [configHome].
#
# ~/.tmux.conf itself is not listed: this project owns that file after
# installation and reinstalls it from its own repository. The `tmux` entry
# covers it for everyone else.
paths = [
  "~/.tmux.conf.local",
  "[configHome]/tmux/tmux.conf.local",
]

exclude = []

secret = []

# No machine_lines: .tmux.conf.local is theme colours, status-line segments,
# key bindings and the powerline glyph choices — the settings whose whole point
# is to follow the user. The one line that is machine-local in a tmux config,
# `set -g default-shell`, lives in .tmux.conf and has its rule in the `tmux`
# entry.