otty / dotfiles

All tools/gmailctl

gmailctl

This utility helps you generate and maintain Gmail filters in a declarative way.

Detected by gmailctl | macOS, Linux, Windows |github.com

Sync it gmailctl.toml

Sync rules

What travels, what stays, what never leaves

gmailctl in your home directory Every rule on this page, by file

· config.jsonnet Sync

· config.yaml Sync

· credentials.json Never synced

· token.json Never synced

· config.jsonnet Sync

· config.yaml Sync

· credentials.json Never synced

· token.json Never synced

· config.jsonnet Sync

· config.yaml Sync

· credentials.json Never synced

· token.json Never synced

· config.jsonnet Sync

· config.yaml Sync

· credentials.json Never synced

· token.json Never synced

Only what the catalog names. A directory that syncs brings everything inside it except what is listed as excluded here.

apps/gmailctl.tomlThe file this page is generated from

id = "gmailctl"

name = "gmailctl"

homepage = "https://github.com/mbrt/gmailctl"

description = "This utility helps you generate and maintain Gmail filters in a declarative way."

detect = ["gmailctl"]

# cmd/gmailctl/cmd/root_cmd.go, the --config flag: "config directory (defaults

# to $HOME/.gmailctl if it exists, else $HOME/.config/gmailctl)", and

# initConfig() implements exactly that — the legacy ~/.gmailctl when it is

# present, otherwise path.Join(xdg.ConfigHome, "gmailctl").

# That xdg is github.com/adrg/xdg, whose config home is not one root this

# catalog names: paths_darwin.go points it at ~/Library/Application Support and

# paths_windows.go at %LOCALAPPDATA% (not %APPDATA%), while Linux keeps

# ~/.config. So the three spellings are written out, the way apps/act.toml does

# for the same library.

# The file inside is config.yaml if present, else config.jsonnet —

# configFilenameFromDir() in cmd/gmailctl/cmd/config.go.

paths = [

"~/.gmailctl/config.jsonnet",

"~/.gmailctl/config.yaml",

"~/.config/gmailctl/config.jsonnet",

"~/.config/gmailctl/config.yaml",

"~/Library/Application Support/gmailctl/config.jsonnet",

"~/Library/Application Support/gmailctl/config.yaml",

"%LOCALAPPDATA%/gmailctl/config.jsonnet",

"%LOCALAPPDATA%/gmailctl/config.yaml",

]

exclude = []

# localcred/local_provider.go names both files: credentialsPath() is

# credentials.json and tokenPath() is token.json, the latter written with mode

# 0600. credentials.json is the Google Cloud OAuth client secret, handed

# straight to google.ConfigFromJSON in internal/engine/api/auth.go; token.json

# is a marshalled oauth2.Token with the access and refresh tokens in it. Both

# are credentials end to end, in whichever of the four config directories the

# machine resolved.

secret = [

"~/.gmailctl/credentials.json",

"~/.gmailctl/token.json",

"~/.config/gmailctl/credentials.json",

"~/.config/gmailctl/token.json",

"~/Library/Application Support/gmailctl/credentials.json",

"~/Library/Application Support/gmailctl/token.json",

"%LOCALAPPDATA%/gmailctl/credentials.json",

"%LOCALAPPDATA%/gmailctl/token.json",

]

# A CLI: the config is read from disk on each invocation.

side_effect = false

# No machine_lines: the config is the filter rules themselves — the addresses,

# labels and boolean expressions the user wants applied to their one Gmail

# account, which is the same account from any machine.

Use it with your dotfile manager

Same data, in the shape your tool already reads

Opens Otty and adds this tool to what it syncs

Opens otty://sync/add/gmailctl. Otty ships with this catalog, so the link only has to name the tool — nothing is downloaded.

Every one of these keeps all credential files out.