otty / apps

All apps/GNU Emacs

GNU Emacs

emacs

An extensible, customizable, free/libre text editor — and more.

Runs as emacs, emacsclient|macOS, Linux, Windows|www.gnu.org

Open form in Otty otty.toml

Sync rules

What travels, what stays, what never leaves

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

· ~/.emacs Sync

· ~/.emacs.el Sync

· init.el Sync

· early-init.el Sync

· elpa/ Exclude

· eln-cache/ Exclude

· auto-save-list/ Exclude

· transient/ Exclude

· url/ Exclude

· straight/ Exclude

· init.el Sync

· early-init.el Sync

· elpa/ Exclude

· eln-cache/ Exclude

· auto-save-list/ Exclude

· ~/.authinfo Never synced

· ~/.authinfo.gpg Never synced

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

apps/emacs/otty.tomlThe file this page is generated from

id = "emacs"

name = "GNU Emacs"

homepage = "https://www.gnu.org/software/emacs/"

description = "An extensible, customizable, free/libre text editor — and more."

icon = "SimpleIcons:gnuemacs"

executables = ["emacs", "emacsclient"]

[dotfiles]

# Emacs manual, "The Init File": "Traditionally, file ~/.emacs is used as the

# init file, although Emacs also looks at ~/.emacs.el, ~/.emacs.d/init.el,

# ~/.config/emacs/init.el, or other locations."

# "The Early Init File": "Such customizations can be put in the early init

# file, ~/.config/emacs/early-init.el or ~/.emacs.d/early-init.el."

paths = [

"~/.emacs",

"~/.emacs.el",

"~/.emacs.d/init.el",

"~/.emacs.d/early-init.el",

"~/.config/emacs/init.el",

"~/.config/emacs/early-init.el",

]

# What Emacs and its package managers write beside the init file: package.el's

# package-user-dir (elpa), the native-compilation cache (eln-cache), the

# auto-save file list, transient's saved values, url.el's cookie and history

# store, and straight.el's package checkouts.

exclude = [

"~/.emacs.d/elpa/",

"~/.emacs.d/eln-cache/",

"~/.emacs.d/auto-save-list/",

"~/.emacs.d/transient/",

"~/.emacs.d/url/",

"~/.emacs.d/straight/",

"~/.config/emacs/elpa/",

"~/.config/emacs/eln-cache/",

"~/.config/emacs/auto-save-list/",

]

# The auth-source manual ("Help for users") describes ~/.authinfo and

# ~/.authinfo.gpg as the netrc-style files auth-source reads, holding the

# passwords and tokens Gnus, ERC, EWW and package.el send. ~/.netrc is on

# auth-source's default list too, but it is not Emacs' own file, so it is not

# claimed here.

secret = ["~/.authinfo", "~/.authinfo.gpg"]

# No side_effect = false: a running Emacs writes M-x customize settings back

# into the init file, so a consumer must not overwrite it under a live session.

# No machine_lines: the init file is Emacs Lisp, and the machine-local part is

# a path inside an expression — (setq exec-path …), a font name, a Homebrew

# prefix — which prefix matching cannot pick out of the line around it. An

# entry with correct paths and no machine_lines is the honest one here.

[commands]

format = 1

label = "Open in Emacs"

description = "Start Emacs on files or a batch session. Only common startup flags."

quality = "ai-draft"

base = "fig:emacs"

parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/emacs.ts"

license = "MIT"

[[commands.field]]

id = "value"

label = "Files"

type = "path"

position = 0

multiple = true

path = { kind = "any", role = "input" }

sources = ["fig"]

[[commands.field]]

id = "no_init_file"

label = "Skip init file"

type = "boolean"

option = ["--no-init-file", "-q"]

sources = ["fig"]

[[commands.field]]

id = "quick"

label = "Quick start"

type = "boolean"

option = ["--quick", "-Q"]

sources = ["fig"]

[[commands.field]]

id = "debug_init"

label = "Debug init file"

type = "boolean"

option = ["--debug-init"]

sources = ["fig"]

[[commands.field]]

id = "no_splash"

label = "No splash screen"

type = "boolean"

option = ["--no-splash"]

sources = ["fig"]

[[commands.field]]

id = "batch"

label = "Batch mode"

type = "boolean"

option = ["--batch"]

sources = ["fig"]

[[commands.field]]

id = "daemon"

label = "Start daemon"

type = "boolean"

option = ["--daemon"]

sources = ["fig"]

[[commands.task]]

id = "edit"

label = "Open files"

fields = ["value", "no_init_file", "quick"]

required = ["value"]

[[commands.task]]

id = "debug"

label = "Debug init file"

set = { debug_init = [true] }

fields = ["debug_init"]

[[commands.group]]

id = "basic"

label = "Basic"

fields = ["value", "no_init_file", "quick", "debug_init"]

[[commands.group]]

id = "advanced"

label = "Advanced"

fields = ["batch", "daemon", "no_splash"]

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/emacs. 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.