otty / dotfiles

All tools/nomacs

nomacs

a free, open source image viewer, which supports multiple platforms.

Detected by nomacs | macOS, Linux, Windows |nomacs.org

Sync it nomacs.toml

Sync rules

What travels, what stays, what never leaves

Synced3 paths, copied whole to your other machines

[configHome]/nomacs/Image Lounge.inipattern

[configHome]/nomacs/Image Lounge.confpattern

%APPDATA%/nomacs/Image Lounge/settings.ini

Stays on this machineInside a file that otherwise syncs

[configHome]/nomacs/Image Lounge.inilines starting with

recentFilesrecentFolderstmpPathsetupPath

Otty splits these out before upload and puts each machine’s own back on the way down — no templates to write.

Stays on this machineInside a file that otherwise syncs

[configHome]/nomacs/Image Lounge.conflines starting with

recentFilesrecentFolderstmpPathsetupPath

Otty splits these out before upload and puts each machine’s own back on the way down — no templates to write.

Stays on this machineInside a file that otherwise syncs

%APPDATA%/nomacs/Image Lounge/settings.inilines starting with recentFiles, recentFolders, tmpPath, setupPath

…

zoomOnWheel=true

doubleClickForFullscreen=true

logRecentFiles=true

recentFiles=/Users/octocat/Pictures/holiday/IMG_0042.jpg, /Users/octocat/Desktop/screenshot.pngmachine-local

recentFolders=/Users/octocat/Pictures/holiday, /Users/octocat/Desktopmachine-local

pinnedFiles=/Users/octocat/Pictures/reference/palette.png

tmpPath=/Users/octocat/Pictures/inboxmachine-local

setupPath=/Applications/nomacs.appmachine-local

[DisplaySettings]

highQualityAntiAliasing=true

…

Otty splits these out before upload and puts each machine’s own back on the way down — no templates to write. The lines above come from this tool’s test fixture in the catalog.

Stays on this machineInside a file that otherwise syncs

[configHome]/nomacs/Image Lounge.inilines starting with

pinnedFiles

Otty splits these out before upload and puts each machine’s own back on the way down — no templates to write.

Stays on this machineInside a file that otherwise syncs

[configHome]/nomacs/Image Lounge.conflines starting with

pinnedFiles

Otty splits these out before upload and puts each machine’s own back on the way down — no templates to write.

Stays on this machineInside a file that otherwise syncs

%APPDATA%/nomacs/Image Lounge/settings.inilines starting with pinnedFiles

…

logRecentFiles=true

recentFiles=/Users/octocat/Pictures/holiday/IMG_0042.jpg, /Users/octocat/Desktop/screenshot.png

recentFolders=/Users/octocat/Pictures/holiday, /Users/octocat/Desktop

pinnedFiles=/Users/octocat/Pictures/reference/palette.pngmachine-local

tmpPath=/Users/octocat/Pictures/inbox

setupPath=/Applications/nomacs.app

…

Otty splits these out before upload and puts each machine’s own back on the way down — no templates to write. The lines above come from this tool’s test fixture in the catalog.

Excluded

Nothing. nomacs writes no caches or state in your home directory.

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

recentFilesrecentFolderstmpPathsetupPath

Each machine keeps its own copy of these.

pinnedFiles

Each machine keeps its own copy of these.

recentFilesrecentFolderstmpPathsetupPath

Each machine keeps its own copy of these.

pinnedFiles

Each machine keeps its own copy of these.

…

zoomOnWheel=true

doubleClickForFullscreen=true

logRecentFiles=true

recentFiles=/Users/octocat/Pictures/holiday/IMG_0042.jpg, /Users/octocat/Desktop/screenshot.pngmachine-local

recentFolders=/Users/octocat/Pictures/holiday, /Users/octocat/Desktopmachine-local

pinnedFiles=/Users/octocat/Pictures/reference/palette.png

tmpPath=/Users/octocat/Pictures/inboxmachine-local

setupPath=/Applications/nomacs.appmachine-local

[DisplaySettings]

highQualityAntiAliasing=true

…

Each machine keeps its own copy of these.

…

logRecentFiles=true

recentFiles=/Users/octocat/Pictures/holiday/IMG_0042.jpg, /Users/octocat/Desktop/screenshot.png

recentFolders=/Users/octocat/Pictures/holiday, /Users/octocat/Desktop

pinnedFiles=/Users/octocat/Pictures/reference/palette.pngmachine-local

tmpPath=/Users/octocat/Pictures/inbox

setupPath=/Applications/nomacs.app

…

Each machine keeps its own copy of these.

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

apps/nomacs.tomlThe file this page is generated from

id = "nomacs"

name = "nomacs"

homepage = "https://nomacs.org"

description = "a free, open source image viewer, which supports multiple platforms."

# The apple-touch-icon from nomacs.org.

icon = "https://nomacs.org/apple-touch-icon.png"

detect = ["nomacs"]

# ImageLounge/src/DkCore/DkSettings.cpp, the DefaultSettings constructors, which

# carry the paths in their own comments:

# #if defined(Q_OS_WIN)

# QSettings(DkSettingsManager::instance().param().settingsPath(), IniFormat)

# #elif defined(Q_OS_DARWIN)

# // ~/.config/nomacs/Image Lounge.ini

# QSettings(IniFormat, UserScope, organizationName(), applicationName())

# #else

# QSettings() // Unix: ~/.config/nomacs/Image Lounge.conf

# #endif

# — organisation "nomacs", application "Image Lounge". Qt resolves those two

# constructors under $XDG_CONFIG_HOME (else ~/.config) on macOS and Linux

# alike, which is [configHome]; only the extension differs, because macOS is

# pinned to IniFormat while the Unix default is Qt's native format. On Windows

# settingsPath() falls back to `QFileInfo(DkUtils::getAppDataPath(),

# "settings.ini")` and getAppDataPath() is

# `QStandardPaths::writableLocation(AppDataLocation)` — %APPDATA%\<org>\<app>,

# a different file name in a different directory, so it gets its own line.

paths = [

"[configHome]/nomacs/Image Lounge.ini",

"[configHome]/nomacs/Image Lounge.conf",

"%APPDATA%/nomacs/Image Lounge/settings.ini",

]

# A portable install reads settings.ini from beside nomacs.exe instead

# (`isPortable()` compares settingsPath() with applicationDirPath()); that is

# not under the user's home at all, so there is nothing to exclude.

exclude = []

# nomacs signs in to nothing; none of these files is a credential.

secret = []

# Every spelling of the settings file on both rules, because a machine has

# whichever its platform writes and the three names share no last segment, so

# the sibling check cannot pair them — this list is by hand, the way

# apps/pip.toml's is.

# The keys are the [GlobalSettings] group in DkSettings.cpp's save(). Everything

# else in the file — language, sort mode, zoom behaviour, the display and

# slideshow groups — is a preference the user wants carried.

# recentFiles and recentFolders are lists of absolute paths into this machine's

# disk, tmpPath and setupPath are single ones, and all four are rewritten by

# nomacs itself every time the user opens or saves a file. That is session

# state, worth nothing to a human once the session is over, so nothing is kept.

[[machine_lines]]

file = [

"[configHome]/nomacs/Image Lounge.ini",

"[configHome]/nomacs/Image Lounge.conf",

"%APPDATA%/nomacs/Image Lounge/settings.ini",

]

match = { prefix = [

"recentFiles",

"recentFolders",

"tmpPath",

"setupPath",

] }

# pinnedFiles is the one key in that group the user fills in on purpose — those

# are the images they chose to pin — so unlike the recent lists above it is

# worth keeping, so the user can see what was pinned when they rebuild this

# machine. It is a list of absolute paths into this disk and means nothing on

# another, hence a rule of its own rather than a scope on all five keys.

[[machine_lines]]

file = [

"[configHome]/nomacs/Image Lounge.ini",

"[configHome]/nomacs/Image Lounge.conf",

"%APPDATA%/nomacs/Image Lounge/settings.ini",

]

match = { prefix = ["pinnedFiles"] }

scope = "backup"

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/nomacs. Otty ships with this catalog, so the link only has to name the tool — nothing is downloaded.

Every one of these is generated from the same rules as this page. None of them splits recentFiles and recentFolders for you — that part is Otty’s own sync, or a template you write by hand.