'%3e%3cpath%20fill='%23eee'%20d='m0%200%208%2022-8%2023v23l32%2054-32%2054v32l32%2048-32%2048v32l32%2054-32%2054v68l22-8%2023%208h23l54-32%2054%2032h32l48-32%2048%2032h32l54-32%2054%2032h68l-8-22%208-23v-23l-32-54%2032-54v-32l-32-48%2032-48v-32l-32-54%2032-54V0l-22%208-23-8h-23l-54%2032-54-32h-32l-48%2032-48-32h-32l-54%2032L68%200H0z'/%3e%3cpath%20fill='%230052b4'%20d='M336%200v108L444%200Zm176%2068L404%20176h108zM0%20176h108L0%2068ZM68%200l108%20108V0Zm108%20512V404L68%20512ZM0%20444l108-108H0Zm512-108H404l108%20108Zm-68%20176L336%20404v108z'/%3e%3cpath%20fill='%23d80027'%20d='M0%200v45l131%20131h45L0%200zm208%200v208H0v96h208v208h96V304h208v-96H304V0h-96zm259%200L336%20131v45L512%200h-45zM176%20336%200%20512h45l131-131v-45zm160%200%20176%20176v-45L381%20336h-45z'/%3e%3c/g%3e%3c/svg%3e)
Settings
Venicee stores configuration in tool windows and JSON files under your app data folder. There are no environment variables or config files to edit during normal use.
Windows default data folder: %AppData%\Venicee\
Open settings from the main menu:
| Menu | Window |
|---|---|
| Tools → Settings… | Language and themes |
| Sites → Site Manager… | Saved connections |
| Tools → Vault | Master password and saved credentials |
| Tools → Automation… | Background sync jobs |
Application settings
Tools → Settings…
General
The General group is reserved for future options. No settings are available here yet.
Language
| Setting | Description | Default |
|---|---|---|
| Display language | UI language (BCP 47 culture name) | English (en-US) |
Built-in languages include English and Deutsch. Additional languages can be installed as packs in:
%AppData%Veniceelanguages<pack-id>Each pack needs a pack.json manifest and a strings.json translation file. Restart or reload is not required — the language list updates when you open Settings.
Themes
| Setting | Description | Default |
|---|---|---|
| Theme | Active color theme | System (built-in) — follows OS light/dark mode |
Built-in themes:
- System — matches Windows light/dark preference
- Light — fixed light palette
- Dark — fixed dark palette
User themes can be duplicated, renamed, deleted, and edited. Built-in themes cannot be modified.
Theme tokens
When editing a custom theme, these tokens control the UI:
| Token | Purpose |
|---|---|
bg | Main background |
surface, surface-2 | Panels and elevated surfaces |
border, border-strong | Dividers and outlines |
text, text-muted | Primary and secondary text |
accent, accent-soft | Links, buttons, highlights |
selected, hover | List and row states |
danger, ok | Error and success accents |
toolbar-h, statusbar-h | Toolbar and status bar height |
font | Font family stack |
Install community theme packs under %AppData%\Venicee\themes\<pack-id>\ (each folder contains theme.json and tokens.json).
Site connections
Sites → Site Manager…
Each site is a saved connection profile. Double-click a site in the list to connect.
| Field | Description | Default |
|---|---|---|
| Name | Label shown in the site rail | New Site |
| Protocol | Transfer protocol | SFTP |
| Port | Server port; leave empty for the protocol default | Protocol default |
| Host | Server hostname or IP | — (required to connect) |
| Username | Login name | — |
| Password | Used for connect and test; stored only if Save password is checked | — |
| Private key file | Path to an SSH private key (SFTP only) | — |
| Save password in vault | Store the password in the encrypted vault | On |
| Default remote directory | Folder opened on connect (e.g. /) | Server working directory |
Protocol default ports
| Protocol | Default port |
|---|---|
| SFTP | 22 |
| FTP | 21 |
| FTPS (explicit) | 21 |
| FTPS (implicit) | 990 |
Actions
- Save — write changes to
sites.json - Test connection — verify host, credentials, and reachability without opening the workspace
- Connect — save (if needed) and open the workspace
- Delete — remove the site profile
If the vault is locked, a banner prompts you to open Tools → Vault before saving passwords.
Venicee remembers the last local and remote folder per site between sessions (site-state.json).
Credential vault
Tools → Vault
The vault encrypts saved site passwords with AES-256-GCM. The master password is never stored on disk.
| Action | Description |
|---|---|
| Create | Set a master password on first use (with confirmation) |
| Unlock | Enter the master password to access saved credentials |
| Skip for now | Close without unlocking; the app runs but saved passwords are unavailable |
After a successful unlock, Venicee may store a protected key in the OS secure store (Windows Credential Manager) so the vault can auto-unlock on the next launch.
When the vault unlocks, enabled automation jobs start automatically.
Automation
Tools → Automation…
Automation runs background jobs against a saved site. Jobs require an unlocked vault if the site uses a saved password.
Job settings (all job types)
| Field | Description | Default |
|---|---|---|
| Name | Job label in the list | New job |
| Job type | Plugin-provided job implementation | Folder Mirror |
| Site | Target connection | — (choose a saved site) |
| Enabled | Start automatically when the vault unlocks | On |
Folder Mirror
Built-in job type Folder Mirror (venicee.mirror.sync) keeps a local folder in sync with a remote folder.
| Setting | Description | Default | Options |
|---|---|---|---|
| Local folder | Path on your PC | — | Required; folder picker |
| Remote folder | Path on the server | — | Required; remote browser |
| Direction | Sync flow | Upload | Upload, Download, Bidirectional |
| Conflict policy | When both sides changed | LastWriterWins | LastWriterWins, PreferLocal, PreferRemote, KeepBoth |
| Propagate deletes | Mirror deletions to the other side | Off | Checkbox |
| Remote poll interval (s) | How often to check the server for changes | 30 | Minimum 5 seconds |
| Exclude globs | Comma-separated patterns to skip | — | Glob syntax (*, ?) |
Direction details:
- Upload — local changes are pushed to the server; remote changes are detected by polling
- Download — remote changes are pulled to the local folder
- Bidirectional — both sides are watched; conflicts use the policy above
Plugins
Desktop builds load external plugins from %AppData%\Venicee\plugins\ (each subfolder needs a plugin.json manifest). Plugins can add new automation job types with their own settings. Mobile builds do not support external plugins.
Job definitions are stored in automation.json.
Workspace
These options are available in the main transfer window rather than a settings dialog.
| Control | Description | Persisted? |
|---|---|---|
Sites rail collapse (« / ») | Hide or show the site list sidebar | Yes |
| Pane splitter | Resize local vs. remote file panes | Session only |
| File grid columns | Column widths | Session only |
| File grid sort | Sort by name, size, permissions, modified, or owner | Session only |
| Transfer queue tab | Switch between queue and message log | Session only |
| Pause / Resume queue | Hold or continue pending transfers | No |
| Clear completed | Remove finished items from the queue | No |
| Permissions… (remote context menu) | Set Unix file mode (chmod) via octal input | Per action |
| Host key prompt | Trust or reject unknown or changed SSH/TLS host keys | Trust is saved to trusted_hosts.json |
On launch, Venicee reconnects to the last selected site when possible.
Data files
| File | Contents |
|---|---|
app-preferences.json | Language, theme, last site, sites rail state |
sites.json | Site connection profiles |
site-state.json | Last local/remote directory per site |
vault.json | Encrypted credentials |
trusted_hosts.json | Trusted SSH/TLS host key fingerprints |
automation.json | Automation job configurations |
plugin-state/ | Per-plugin persisted state |
Drop-in folders (desktop):
| Folder | Purpose |
|---|---|
languages/ | Community language packs |
themes/ | Community theme packs |
plugins/ | External automation/transfer plugins |
Security summary
- Passwords in site profiles are stored only inside the encrypted vault, never in plain text in
sites.json. - SSH host keys and TLS certificates are verified on connect; you choose whether to trust new or changed keys.
- Venicee does not use accounts or telemetry. Connection settings and credentials stay on your device.
For installation and updates, see Getting started and the download page.