Settings

Settings has six tabs. Most changes save as soon as you make them.

General

• You: your name, shown in Periskopos and never sent anywhere.
• Watch apps in the background: checks each app on its interval and records its history. While it’s off, that time shows as not watched.
• Check new apps: how often a new app is checked, from every minute to every hour. Each app can have its own on its Settings tab. Use this for all my apps replaces every app’s own interval. Slow-moving checks such as certificates and domains keep their own pace.
• Start at login: a switch in the installed app, and also in the tray menu.
• When I close the window (Windows and Linux): keep watching in the system tray, or quit. While Periskopos isn’t running, nothing is checked and no alerts go out.
• Updates: the version you’re running and where updates stand.
• Guided tour: takes the short walk around the app again.

Appearance

• Theme: System, Light or Dark.
• Times: System, 12-hour or 24-hour.
• Open on: the page Periskopos opens on. A link from a notification still goes where it points.
• World’s sky: follows your clock or your theme. See The World.

Notifications

Which alerts you get, pausing them, and alerts on your phone. See Notifications.

AI assistants

Whether assistants can connect, and what each may do. See Connecting an assistant.

Data

• Backups: when the last copy was made, and Back up now. See Backups.
• History: how long every check is kept: 30, 90 or 365 days. A summary of each day is kept for a year either way. Choosing a shorter time deletes the older checks for good, so Periskopos asks first.
• Export and Import: your setup as a file, and that file read back in. See below.
• Restore default settings: puts watching, alerts, pauses and the interval for new apps back to how Periskopos starts, and switches AI assistants off. Your apps, accounts, keys and history stay, and so do where phone alerts go and how long checks are kept.

About

The version, where your data and keys file are, links to these docs, and buttons to open the data folder, show the log and copy diagnostics for a bug report.

Moving to another computer

There are two ways, and neither brings your keys. Those live only in the keys file, so you paste each one again in Accounts.

	A backup	An export
Apps, checks and settings	Yes	Yes
History	Yes	No
Accounts	Yes, without their keys	Only their names
What happens to what’s there	Replaces it	Adds to it
How you use it	Restore it	Import in Settings → Data

Use a backup to carry everything over to a new install. Use an export to add your apps to a Periskopos that’s already in use, or to keep a copy you can read: it’s a plain JSON file.

Exporting

Export my setup in Settings → Data saves periskopos-setup-<date>.json: your apps, their checks, your accounts’ names and your settings. It holds no keys and no history. Your apps’ addresses and your phone alert addresses are in it, so treat it as private.

Importing

Choose the file under Import in Settings → Data. Periskopos lists what it would do, and nothing changes until you press the button.

• New apps are added with their notes, interval and checks. A check you removed before exporting stays removed.
• Apps you already have stay as they are, apart from connections through your accounts. An app counts as the same when its URL matches, and if several share a URL, its name decides. Importing the same file twice doesn’t add anything twice.
• Anything that can’t be read is listed and left out, and the rest still comes in. Everything in the file goes through the same checks as adding it by hand.

Importing never runs an action, and AI assistants can’t import: it’s done on screen only.

Accounts and connections

Accounts can’t come from the file, because their keys aren’t in it. The list shows which ones to add. A connection that needs an account uses the account of the same name, or the only one of that kind if you have just one. If there’s no match, it waits.

To bring those connections in, add the accounts in Accounts, then import the same file again. Your apps stay as they are and gain only the connections that were waiting.

If an app used the protocol, its endpoint has to be connected again on its Settings tab, because its secret is in the keys file too.

Settings in the file

The preview lists any of these that differ from yours, and they only change if you tick Also use the file’s settings:

• Notify me, the provider alarm and each kind of alert
• Check new apps

Nothing else comes from a file, whoever made it: not whether AI assistants are let in, not where alerts go, not whether watching is on, not how long checks are kept, and not pauses.