Configuration file format
An exported config is a single JSON object with two top-level keys:theme and commands.
celerity-config-2024-01-15.json
Each entry inside
commands supports the following properties:
Exporting your config
Export saves a snapshot of your current theme and all shortcuts as a dated JSON file.1
Open Settings
Click the gear icon in the top-right corner of any new tab page, or press Alt + +.
2
Scroll to the Config section
The Config section is at the bottom of the Settings panel, below the theme picker.
3
Click Export Config
Click the Export Config button. Your browser downloads the file automatically — no save dialog appears.
4
Locate your file
The file is saved to your default downloads folder and named
celerity-config-YYYY-MM-DD.json using today’s date (e.g. celerity-config-2024-01-15.json).Importing a config
Import reads a previously exported.json file and replaces your current shortcuts and theme with the contents of that file.
1
Open Settings
Click the gear icon or press Alt + +.
2
Click Import Config
Click the Import Config button. Your browser’s file picker opens — only
.json files are accepted.3
Select your backup file
Navigate to your saved
celerity-config-YYYY-MM-DD.json file and open it.4
Confirm the import
A confirmation dialog warns that your current configuration will be replaced. Click Import to proceed, or Cancel to abort without making any changes.
Celerity automatically upgrades legacy config files. The old theme name
dark-abyss is silently mapped to void, so backups from earlier versions import correctly.Resetting to defaults
Reset replaces everything — your shortcuts and your theme — with Celerity’s factory defaults. Use this when you want a clean slate.1
Open Settings
Click the gear icon or press Alt + +.
2
Click Reset to Default
Click the Reset to Default button in the Config section.
3
Confirm the reset
A confirmation dialog asks you to verify. Click Reset to proceed, or Cancel to keep your current setup.
4
Review the restored defaults
All custom shortcuts are removed and the 12 built-in shortcuts (Gmail, YouTube, Netflix, and so on) are restored. The theme resets to System preference, which follows your operating system’s light or dark mode setting.
Reset cannot be undone. Export your config before resetting if you want to preserve your current shortcuts.