Repository navigation
Data Files
zhugecaomao edited this page Nov 12, 2026
·
17 revisions
English · 中文
| Situation | Location |
|---|---|
| Default (the program folder is writable, portable) |
Data\ in the program folder |
The program folder isn't writable (for example under C:\Program Files) |
%APPDATA%\ALTRun\Data\ |
| You picked another folder in Preferences → Advanced → Data → Change Location | That folder (the ALTRun.json in the default location only keeps a DataLocation entry pointing there; it can have environment variables, for example %OneDrive%\ALTRun\Data-%COMPUTERNAME% for a folder per PC), see Using the same settings on several PCs
|
Preferences → Advanced → Data → "Open Data Folder" opens it.

| File | Contents | If you delete it |
|---|---|---|
ALTRun.json |
All settings, custom commands, snippets, hotkeys and web searches, see Settings reference | Settings go back to defaults and your commands and snippets are gone (this is the file to back up) |
ALTRun.json.bak |
The settings as they were before the last save. When ALTRun.json can't be read (a format error, or damaged by a power cut), ALTRun offers to start with this backup instead of the defaults |
No effect |
ALTRun.reset.backup.json |
Backup taken by Preferences → Advanced → "Restore Defaults" | No effect |
ALTRun.v<version>.backup.json |
Backup taken before the settings format was upgraded; <version> is the settings version before the upgrade (for example ALTRun.v5.backup.json when upgrading from 5 to 6) |
No effect; use it to go back to an older version |
ALTRun.json.bad |
When the settings file has a format error, the original is kept under this name (and ALTRun offers ALTRun.json.bak); fix it and rename it back to ALTRun.json. A file that can't be opened at all (another program is using it, or a cloud file is offline) is not renamed: ALTRun tries for a couple of seconds, then asks whether to try again or quit, and changes nothing |
No effect |
AppIndex.json |
App index | Rescanned at startup |
FileIndex.bin |
Built-in file index (used without Everything) | Rescanned in the background |
Knowledge.json |
Learned ranking, search history, recent items (pinned items are in ALTRun.json) |
Ranking has to be learned again, recent items are cleared |
Knowledge.v1.backup.json |
Knowledge.json before it was converted to the format of settings version 7 (custom commands, snippets and sync tasks by their Id) |
No effect; use it with ALTRun.v6.backup.json to go back to an older version, see FAQ
|
Usage.json |
Usage statistics (how often each feature was used each day) | Statistics start from zero |
ClipboardHistory.json |
Clipboard history (text; only here when Preferences → Clipboard → "Save in" isn't "Everything on this PC only"). When it can't be opened at startup it is left alone and read again before anything is saved; one with a format error is kept as ClipboardHistory.json.bad
|
History is cleared |
Clipboard\ |
Images and very long items of the clipboard history (only here when "Save in" is "The Data folder") | Those items no longer show in the history |
Currency.json |
Exchange rates for currency conversion (only once it is turned on) | Downloaded again at the next start |
Update.json |
Time of the last update check, skipped versions | Checked again at the next start |
Icons\ |
Web search icons saved by "Download Site Icon" | Those engines use the default icon |
Apart from ALTRun.json, every file is created at runtime and simply rebuilt if deleted.
| Location | Contents |
|---|---|
%LOCALAPPDATA%\ALTRun\IconCache\ |
Icon cache (Icons-<size>.bin) so icons show at once after a restart; one per PC, rebuilt automatically if deleted |
%LOCALAPPDATA%\ALTRun\ClipboardHistory.json, %LOCALAPPDATA%\ALTRun\Clipboard\
|
Clipboard history, with its images and very long items in Clipboard\ (kept here by default so it doesn't follow a sync folder or USB stick); with "Images and long items on this PC only", only Clipboard\ is here |
Themes\ in the program folder (%APPDATA%\ALTRun\Themes\ if it isn't writable) |
Your own themes, see Themes |
Scripts\ in the program folder (%APPDATA%\ALTRun\Scripts\ if it isn't writable) |
Your own scripts, see Scripts |
%Temp%\ALTRun.log |
Debug log, written only with Preferences → Advanced → "Write a debug log" on; an unexpected error (with where it happened) is written even when it is off |
%Temp%\ALTRun\SyncLogs\ |
Folder Sync logs (<task>_<date>.log) of the tasks without a log file of their own; those older than 30 days are deleted when a task runs |
For the startup, Start menu and "Send to" shortcuts, the administrator helper's scheduled task and the Delayed Start tasks, see Uninstalling.
-
One file is enough:
ALTRun.jsonholds every setting, custom command and snippet. To take the learned ranking along too, back up the whole Data folder (the clipboard history is on this PC by default, see above) -
New PC: copy the whole program folder (including
Data\); use path variables in paths so they still work with a different user name - Syncing several PCs: move the data folder into a sync folder, see Using the same settings on several PCs. Don't change settings on two PCs with ALTRun open at the same time, or the sync service may create conflict copies
- Snippets only: Preferences → Snippets → More ▾ → Export to CSV saves them as CSV, see Snippets
ALTRun · GPL-3.0 · Something wrong or unclear? Open an issue or edit docs/wiki · 文档有误或不清楚? 欢迎提交 Issue 或修改 docs/wiki
English
- Getting started
- Installation and upgrades
- Search and shortcuts
- Pinned and recent items
- File search
- Browser bookmarks
- Web search
- Window switching
- Custom commands
- Snippets
- Clipboard history
- Calculator
- System commands and terminal
- Scripts
- Custom hotkeys
- Delayed start
- Folder sync
- Themes
- Quick Switch
- Dialog Folder Panel
- Date Stamp
- PT Tools
- Extensions
- Settings reference
- Data files
- Privacy and network access
- FAQ
- Development guide
- Contributing
- 5 分钟上手
- 安装与升级
- 搜索与快捷键
- 置顶和最近使用
- 文件搜索
- 浏览器书签
- 网页搜索
- 窗口切换
- 自定义命令
- 文字片段
- 剪贴板历史
- 计算器
- 系统命令和终端
- 脚本扩展
- 自定义热键
- 延迟启动
- 文件夹同步
- 主题
- 对话框快速跳转
- 对话框文件夹面板
- 一键加日期
- PT 工具箱
- 扩展功能
- 设置文件参考
- 数据文件
- 隐私与网络访问
- 常见问题
- 开发指南
- 参与贡献