# Settings

Open Settings with `Ctrl+,`. Use the search box to find a setting. Changes apply
immediately, and Settings works while the server is offline.

## Sections

| Section | What's in it |
| --- | --- |
| General | Closing behavior, the app that opens files, window size, worktree locations |
| Composer | Dictation, clearing, image submission, font |
| Appearance | Language, light and dark themes, sidebar, status bar |
| Keyboard | Every shortcut. See [Keyboard shortcuts](https://nana.areshk.dev/docs/user-guide/keyboard-shortcuts.md) |
| Commands | Your own commands, each run in a new tab, with optional shortcuts |
| Terminal | Fonts, spacing, transparency, colors, cursor, padding, selection, scrolling, key bindings |
| Browser | The [built-in browser](https://nana.areshk.dev/docs/features/browser.md): terminal links, search engine, home page, profiles, import |
| Server | This computer's [server](https://nana.areshk.dev/docs/features/server.md#settings): shell, history, shell integration, stop and restart |
| Kibbles | Installed kibbles and the marketplace |
| AI | Tools and prompts for [Git](https://nana.areshk.dev/docs/features/git.md) actions |
| Backup & Restore | Export and restore |

## Files

Settings are plain files in Nana's
[profile folder](https://nana.areshk.dev/docs/features/server.md#files). **Edit in…** at the top of a
section opens its file.

| File | Holds |
| --- | --- |
| `settings.toml` | App preferences, shortcuts (`[keymap]`), commands, remote servers |
| `terminal.toml` | Terminal preferences and key bindings |
| `themes/` | Your own themes |
| `server.toml` | Server settings |

- Restart the app after editing `settings.toml` by hand. If the file has an
  error or an unknown key, the app won't open; see
  [Troubleshooting](https://nana.areshk.dev/docs/user-guide/troubleshooting.md#the-app-doesnt-open).
- Hand edits to `terminal.toml` apply when Nana or Settings becomes active. If
  the file has an error, Settings shows it and keeps the last good values.

## Terminal configuration

Use **Settings → Terminal** for:

- Font family, fallback fonts, bold and italic fonts, size, line and character
  spacing, ligatures and other font features, fonts for Unicode ranges, thicker
  strokes, and bright colors for bold text.
- Background transparency, optionally including colored cells.
- Cursor shape, blinking, opacity, and thickness. Thickness accepts an adjustment in
  physical pixels or a percentage: `1` adds one pixel and `100%` doubles it.
  It applies to bar, underline, and outlined cursors. Terminal programs can
  override cursor shape and blinking.
- Separate sliders for left, right, top, and bottom padding, with balanced
  unused space and a padding color.
- Background, text, cursor, selection, and the 16 ANSI colors. Each replaces
  the theme's color; leave it empty to use the theme.
- Copy on select, clearing selection when typing or copying, mouse reporting,
  separate trackpad and mouse wheel speeds, and scrolling to live output.
- The working directory for new panes.
- Key bindings the terminal handles while focused: record a key, then pick an
  action such as sending text. They win over app shortcuts. You can also turn
  off the built-in terminal bindings.

Numeric controls use sliders, on/off options use switches, and fixed choices use
dropdowns. Sliders preview changes while dragging and save when released or when
Settings closes. Spacing and thickness offer a pixels/percent dropdown; changing
units keeps the numeric adjustment within the supported range.

**Reset terminal settings**, at the bottom of the section, returns everything
on it, including key bindings, to its default after you confirm.

Themes remain in **Settings → Appearance**. Shell and history limits remain
in **Settings → Server**.

## Themes

Nana ships about 490 themes. Pick the app's light and dark themes in
**Settings → Appearance**, or press `Ctrl+Alt+K`. Nana follows the system's
light or dark mode.

Custom themes in the profile's `themes/` folder show up too. The chosen theme
colors the app and its terminals.

## Backup and restore

- **Export…** saves a `.nana` file with your settings, `terminal.toml`, themes,
  server settings, kibble preferences, remote server list, and local
  projects with their layouts.
- **Choose file…** under **Restore backup** restores on the next launch. Nana
  keeps a recovery copy in the profile's `Backups/` folder. Existing projects
  are kept and get the saved layouts.
- Backups never include running terminals, paired phones, kibble packages,
  remote projects, or project files.

## Kibbles

**Settings → Kibbles → Browse** installs kibbles from the marketplace.
New kibbles start disabled; review their permissions and turn them on.
Updates are manual: use **Update all**, or update one from its page. Building
your own? See [Kibbles](https://nana.areshk.dev/docs/extensions/overview.md).

Language packs are kibbles too. Pick a language in **Settings → Appearance →
App language**, or choose **Browse language kibbles…**.