Skip to content
Back

Background pickerPro

Picture tiles we draw ourselves plus Your own, with Film, Static or Dither laid over the picture and a home screen preview.

oxyn add background-picker

Background

Sits behind the home screen. Moving pictures play too.

Texture

Grain drawn over the picture. Press again for none.

The code is part of Oxyn Pro

The preview stays free for everyone. Pro opens the code of every Pro component, screen, agent-app template, block and kit, plus the Pro CLI.

Get Pro

Rendered from Rust at build time · goes live when visible

When to use

  • Let someone put a picture behind their home screen, or their own, and lay a texture over it, seeing the result before leaving the page.

When not to use

Installation

Background picker is part of Oxyn Pro; the preview is free. Pro items install with the oxyn CLI once your licence is signed in; until then Pro members copy the code from this page.

Terminal
oxyn add background-picker

Usage

Dioxus · rust
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Examples

Default

Plain default picked: a home screen preview over six tiles, the last one for your own picture.

Background

Sits behind the home screen. Moving pictures play too.

Texture

Grain drawn over the picture. Press again for none.

Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Orbit with film

A drawn planet's edge behind the home screen with film grain laid over it.

Background

Sits behind the home screen. Moving pictures play too.

Texture

Grain drawn over the picture. Press again for none.

Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Neon dithered

Out-of-focus lights under an ordered dot texture.

Background

Sits behind the home screen. Moving pictures play too.

Texture

Grain drawn over the picture. Press again for none.

Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Tiles only

No preview, two columns: the picker as it sits in a narrow settings pane.

Background

Sits behind the home screen. Moving pictures play too.

Texture

Grain drawn over the picture. Press again for none.

Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

API reference

BackgroundPicker

PropTypeDefaultDescription
default_pickString"default"Starting tile key (`default`, `canopy`, `orbit`, `neon`, `tide`).
default_textureString"none"Starting texture key (`none`, `film`, `static`, `dither`).
previewbooltrueThe home screen preview above the tiles.
colsusize3Tile columns (2–4).
on_changeEventHandler<(String, String)>—The background or texture changed: (tile key, texture key).

Read from the Rust signature and doc comments.

Keyboard interactions

KeyAction
TabEach tile, Your own, then each texture
EnterorSpace on a tileMakes it the background
EnterorSpace on Your ownOpens the file picker
EnterorSpace on the lit textureTakes the texture off

Accessibility

  • Tiles are a radio group; each picture is named and described in a few words.
  • Your own is a real file input (images up to 8 MB); a wrong file says why in the live note.
  • Each texture reports its state through aria-pressed; the preview is an image labelled with the picture and texture.

Responsive behaviour

  • 560 px card; tiles drop to two columns and the texture row stacks under 480 px.
Edge cases (spec)

Tiles drop to two columns and the texture row stacks under 480 px.

Notes for AI

  • Import BackgroundPicker from oxyn_dioxus and include STATUS_INDICATOR_CSS plus the token stylesheet once.
  • A GPUI version exists: BackgroundPickerEl in oxyn_gpui.
  • Keep its states and timings as they ship; restyle it through the CSS variables rather than by hand.

Guides

Oxyn · 74 free components · 264 Pro components · 96 screens · 20 blocks · Dioxus and GPUI