How to Set Up Widgets in Atmos

Widgets are one of the biggest systems inside Atmos, even though they can look lightweight at first.

They are not just small pieces of interface inside the app window. Atmos widgets live in their own desktop-level overlay, persist their layout and settings, and can become part of a full exported Atmos profile. That makes them much closer to a real desktop layer than to a temporary in-app panel.

This guide explains how to set up widgets in Atmos, how the widget overlay behaves, and which hidden details make the system easier to use once you know where to look.

What Atmos widgets are

Atmos widgets are customizable desktop elements that can show information, media state, personal text, or decorative content directly on the desktop.

They are grouped into categories such as:

• Time
• System
• Media
• Calendar
• Info
• Personal
• Notes
• Creative

That range is one reason the widget system feels bigger than a simple clock add-on. Atmos widgets can be practical, expressive, or purely atmospheric depending on how you build the setup.

Where widgets live in the app

Widgets are managed from the Widgets area in the Library flow.

From the main Library view, the Widgets row acts as the entry point into the dedicated widget interface. If widgets are enabled and at least one widget exists, the row also shows a count, which makes it easy to see whether your desktop widget layer is currently active.

This is different from Audio, Background, Cursor, and Trails, which mostly expose their controls directly in expandable sections. Widgets are large enough as a system that they have their own dedicated view.

Widgets live in a desktop overlay, not inside the Atmos window

This is the most important structural detail to understand early.

When widgets are enabled, Atmos creates a separate transparent overlay window at desktop level. That overlay:

• sits above the desktop layer
• joins all spaces
• stays visually present even outside the main Atmos window
• does not intercept normal mouse events when you are not editing

That is why widgets feel like part of the desktop rather than like floating content inside the app panel.

How to add your first widget

To add a widget:

1. Open Atmos.
2. Go to the Library area.
3. Open Widgets.
4. Choose Add Widget.
5. Pick a category.
6. Pick a widget type from that category.

When you add a widget, Atmos creates a new widget entry with:

• a widget type
• a default size
• a default style
• default settings for that type
• a starting centered position

That means a new widget is not just a visual card. It is a saved object with its own configuration and future edit path.

Hidden behavior: adding a widget can enable widgets automatically

This is a useful detail for first-time setup.

If widgets are currently disabled and you add one from the browser, Atmos automatically enables the widget system so the new widget becomes visible.

That saves you from the awkward first-run case where you add a widget successfully but do not see anything happen because the overlay is still turned off.

How widgets are organized when you browse them

The add flow is split into two stages:

1. category selection
2. widget browser for that category

The category browser gives you a clean entry point rather than dumping every widget into one long list. After choosing a category, Atmos shows live preview cards for the available widget types in that group.

These previews are not static screenshots. The browser uses stable preview widget instances so the previews do not constantly reseed or flicker while you browse.

That is a small implementation detail, but it helps the widget browser feel polished.

The widget types available in Atmos

The widget catalog is broad enough that it is better to think in families than in one flat list.

The current system includes types such as:

• digital and analog clocks
• world clock and date widgets
• battery, CPU, RAM, network, disk, and uptime widgets
• now playing and waveform widgets
• month, week, day, year, moon, and sunrise widgets
• quote, affirmation, greeting, and name widgets
• sticky notes, bullet lists, and memos
• fun facts and word-of-the-day widgets
• creative widgets such as aura, aurora, and constellation

This is why widget setup is worth its own tutorial. There is enough variety here that the system becomes a real part of the app’s identity.

How widget positioning works

Every widget stores its position as normalized desktop coordinates rather than as a one-off transient drag state.

That means the system remembers where the widget belongs on the screen instead of simply leaving it where it happened to be last rendered.

When you move a widget, Atmos saves:

• its horizontal position
• its vertical position
• its scale
• its styling and content settings

This is what allows widgets to survive relaunches and profile exports cleanly.

Edit mode is the key to managing widgets

Widgets are primarily interactive through edit mode.

When edit mode is on, Atmos shows edit chrome around widgets and starts listening for widget-specific interactions such as:

• selecting a widget
• dragging it
• resizing it
• deleting it

Outside of edit mode, widgets are mostly meant to sit quietly on the desktop rather than behave like constantly interactive app controls.

This separation is important because it keeps the desktop feeling calm during normal use.

How dragging and resizing work

In edit mode:

• dragging the widget body moves it
• dragging the resize handle changes its scale
• clicking the delete control removes it

Atmos also keeps live drag and live resize state while you are moving the widget, so the placement feels direct rather than delayed until after the interaction ends.

When you release the widget, the final position or scale is saved into the widget configuration.

Hidden behavior: tapping a widget opens its options panel

Another important detail that is easy to miss:

In edit mode, clicking the widget body does not only select it for movement. A tap on the widget can also open that widget’s options panel inside the Atmos interface.

If you tap the same widget again, the panel can close.

Atmos also brings the app window forward when this happens, which makes the widget-editing loop much smoother than if the desktop overlay and settings panel were completely disconnected.

Snap to grid

Atmos supports optional snap-to-grid placement for widgets.

When snap-to-grid is enabled:

• moved widgets snap to a fixed spacing
• placement becomes more structured
• the layout feels cleaner and more aligned

The system also stores the current grid division count, which controls how coarse or fine the snapping behavior is.

If snap-to-grid is off, widgets can be placed more freely.

This is one of the most useful hidden layout controls in the entire widget system because it changes the feel of your desktop immediately.

Widgets are clamped so they stay usable

When you move a widget, Atmos does not let it drift infinitely off-screen.

The stored position is clamped to a safe range so the widget stays meaningfully present on the desktop instead of being saved to an unusable location.

This is the kind of small guardrail that users may never notice directly, but it helps prevent accidental layout loss.

Widget styles

Each widget has a style setting separate from its content type.

The current style system includes:

• Clear
• Glass
• Dark
• Tint

This means the same widget can feel subtle, solid, translucent, or more expressive depending on how you style it.

If the selected style is Tint, Atmos also exposes gradient hue controls so you can shape the widget’s color direction more precisely.

Global appearance controls inside each widget

Every widget can also carry its own appearance settings, including:

• opacity
• font design
• font weight
• color mode
• corner radius
• scale

This is important because widgets are not limited to one app-wide style preset. You can keep the system cohesive or deliberately mix different moods depending on the setup you want.

Widget-specific settings are different from general style settings

The options panel has two layers:

1. general appearance controls
2. widget-type-specific controls

Examples of type-specific settings include:

• 24-hour mode, seconds, and date visibility for digital clocks
• seconds hand for analog clocks
• city label and timezone for world clocks
• custom names for greeting and name widgets
• note text for sticky note and memo widgets
• hue controls for aura and aurora-style widgets
• constellation selection for the constellation widget

This distinction matters because not every widget type needs the same controls.

Widgets use sensible defaults by type

When you add a widget, Atmos chooses a default size based on the type.

For example:

• larger layouts are used for big visual or time widgets like digital clocks, analog clocks, and month views
• medium layouts are used for widgets like now playing, memo, waveform, and some creative widgets
• smaller layouts are used for many lighter information widgets

That makes the first add experience better because a widget usually starts at a reasonable scale for what it is.

Widgets save continuously

Another hidden but important behavior: widget changes are autosaved.

The widget config saves when key values change, including:

• widget list
• enabled state
• snap-to-grid
• grid divisions
• widget settings

That means you do not need a manual save button for ordinary widget edits. Atmos treats widget configuration as persistent state, not as a draft.

Widgets survive relaunches and broken items do not wipe everything

Atmos stores widget configuration in its own saved file under Application Support.

The load path is intentionally tolerant: if one widget fails to decode cleanly, Atmos does not throw away the entire widget configuration. It tries to keep the valid widgets instead.

This is a subtle reliability feature, but it matters for a system that can accumulate many independently configured items over time.

Widgets are part of profile export and import

Like several other Atmos systems, widgets are portable.

When you export an Atmos profile, the widget configuration snapshot includes:

• the widgets themselves
• whether widgets are enabled
• snap-to-grid state
• grid division settings

When you import that profile later, Atmos can rebuild the widget layout from the snapshot.

This is one of the reasons widgets are not just cosmetic extras. They are part of a full Atmos environment.

Hidden behavior: widget editing only works when Atmos intends it to

The widget overlay always ignores direct mouse events at the window level. Actual widget interactions are coordinated through Atmos’s event monitoring and edit mode logic.

That gives the app tight control over when widgets should be:

• passive desktop elements
• editable layout objects

This design helps avoid a messy desktop where widgets constantly interfere with normal interaction.

A practical first widget setup

If you want a clean first setup, start with a small mix:

1. Add one clock widget.
2. Add one media or now playing widget.
3. Add one personal or note widget.
4. Turn on edit mode.
5. place them in a simple triangle or column layout.
6. enable snap-to-grid if you want a neater arrangement.
7. adjust opacity and style before changing deeper settings.

This gives you a useful setup quickly without overbuilding the desktop on day one.

Useful hidden details in the widget workflow

Here are the details most users are likely to miss:

• Widgets live in a desktop overlay, not inside the main app window.
• Adding a widget can enable the widget system automatically.
• Edit mode is required for real widget management.
• Clicking a widget in edit mode can open its options panel and bring the Atmos window forward.
• Dragging moves a widget, while the corner control handles resize behavior.
• Snap-to-grid is optional and saved.
• Widget settings autosave continuously.
• Widgets are included in Atmos profile export and import.

These are the details that make the widget system feel much more capable once you understand it.

Final thoughts

Widgets are one of the clearest examples of Atmos acting like a desktop environment layer rather than a simple menu bar utility. They live in their own overlay, remember where they belong, support real editing and styling, and travel with your saved profile.

Once you understand the add flow, edit mode, snap-to-grid, and the difference between general style controls and widget-specific settings, the system becomes much easier to shape around your own desktop.

In the next tutorial, we will stay with widgets and focus on the best Atmos widgets for everyday use.