TandemDocs

Make it yours3 min read

Widgets

Widgets are small live cards: your free storage, the battery, a clock, play stats, what's running and more. They sit in a row on the home screen (under Continue playing) and on the bottom screen whenever nothing is highlighted.

On this pageAdding and arrangingOn the icon gridThe widgetsBattery and privacy

Adding and arranging

Open Settings › Home & layout › Widgets › Customize widgets, or press Y on any widget and pick All widgets….

ButtonIn the widget editor
L1 / R1Switch between the top screen and the bottom screen
ACustomize the highlighted widget, or add one on + Add a widget
YThe highlighted widget's options
BBack

Every widget has:

  • Size: Small, Medium, Wide or Tall. On the bottom screen (two columns) Wide is a big card two rows high.
  • Show on: the home screen, the bottom screen, or both.
  • Its own settings, such as the clock style or which list the storage widget shows. Left and right change a setting too.
  • Move: the widget wiggles; move it with the D-pad and press A (or B) when it's in place.
  • Remove widget. The message offers Undo for 6 seconds.

On the home screen the widget area has one row, or two when a Tall widget is there. You can fix it at one or two rows in the editor.

On the icon grid

With the icon grid as home, widgets can also sit on the grid itself, among the icons. Press A on an empty spot and pick Add here › Widget…. A widget on the grid covers 1×1, 2×1, 1×2 or 2×2 cells; Small, Medium, Tall and Wide sizes draw as those. Y on it gives Widget options… (the same settings as above), Move, Resize and Remove widget (under More). While moving it, Y changes its size to the next one that fits.

Settings › Home & layout › Widgets › Widgets on the grid chooses where Add here › Widget… puts a new widget: In cells (the default) or As a row, in the widget row at the end of an up-and-down grid. Widgets already placed stay where they are.

The widgets

WidgetWhat it showsA does
StorageInternal and SD card usage rings, the biggest systems or folders, art and cache sizesMeasures again
BatteryCharge, charging, temperature and time left (when Android knows it)Opens quick settings
ClockDigital, analog or big and friendly; seconds and 12/24-hour optionalSwitches the style
Now playingThe game waiting in the background (needs Shizuku)Resumes it
Continue playing, Favorites, Recently addedYour games in a strip; left and right pick onePlays it
Surprise meA random game (never played, everything or favorites)Plays it; the 🎲 picks another
Play statsToday, the last 7 days, your streak and a little chartOpens play stats
AchievementsYour latest RetroAchievements unlocks (only when signed in)Opens the achievements tab
PipPip, reacting to the time of day and your streakPip says something else
Up nextYour list of games to play nextPlays the game (or edits a note)
System monitorFree memory, CPU temperature when Android shares it, uptimeNothing
App shortcutsYour dock appsOpens the app
GreetingPip, the time and your last game (the bottom screen's default)Plays your last game

To put a game on Up next, press Y on it and choose Add to Up next, or press A on the + at the end of the widget and type a name. A name that matches one game adds that game; anything else is kept as a note. The widget's Y menu removes entries and clears played games.

On the bottom screen widgets work by touch: tap a game to play it, tap the 🎲 to reroll.

Battery and privacy

Widgets only update while Tandem is on screen; nothing runs while you play. Storage sizes are measured in the background when you come back to Tandem, at most every 15 minutes, and the measuring stops the moment you start a game. Widgets never use the network, except Achievements, which uses your RetroAchievements account the same way the stats screen does.

Last updated Edit this page on GitHub

Tandem is free software under the GNU GPL v3 or later. These pages are built from the Markdown in the repository; no cookies, no tracking.