palette

Customize Desktop

Choose Wallpaper

check Custom wallpaper applied
2:28
PM
Friday
move Move
settings Settings
close Close Widget
search
settings
Settings
edge
Edge
explorer
Explorer
photos
Gallery
terminal
Terminal
taskmgr
Task Mgr
system
System
vscode
VS Code
taskmgr Task Manager
minimize
maximize
close
NameStatusCPUMemory
cpuWidTronic Engine
Running0.0%20.4 MB
desktopDesktop Window Manager
Running2.4%145.2 MB
shieldWindows Defender
Running1.1%210.0 MB
edgeMicrosoft Edge
Running4.8%840.5 MB
folder File Explorer - WidTronic
minimize
maximize
close
settings Settings
minimize
maximize
close

๐Ÿ–ฅ๏ธ This is a Demo

Settings will be available in the full application.
Download WidTronic to customize your widgets!

terminal Terminal
minimize
maximize
close
PS C:\Users\User> npm run dev
Starting development server...
โ–ฒ Next.js 16.0.0
- Local: http://localhost:3000
โœ“ Ready in 1.2s
$ WidTronic Engine v2.0.0 initialized
PS C:\Users\User> _
windows
explorer
terminal
taskmgr
settings
wifi
volume
battery
2:28 PM
20-03-2026
Scroll down to read the docs
Search documentation... โŒ˜K

What is WidTronic?

WidTronic is a 20MB disk / 20MB RAM desktop widget engine built entirely in Python. It renders customizable widgets โ€” clocks, system monitors, weather info, and more โ€” directly on your desktop with minimal overhead.

Unlike heavy widget suites that consume hundreds of megabytes, WidTronic stays lean. It's designed to coexist with Wallpaper Engine and other live wallpaper tools without competing for resources.

WidTronic is 100% open source. Every line of code is available on GitHub. Audit it, modify it, redistribute it freely.

Why WidTronic?

Ultra Lightweight

20MB disk, 20MB RAM. Less than a browser tab.

100% Safe

Open source, no telemetry, no cracked binaries.

Compatible

Works alongside Wallpaper Engine & live wallpapers.

Customizable

Edit config files, create themes, build presets.

Resource Comparison

ToolDiskRAMOpen Source
WidTronic20 MB~20 MBYes
Rainmeter45 MB~60 MBNo
Desktop Gadgets30 MB~80 MBNo
Widgetsmith50 MB~100 MBNo

Prerequisites

Before installing WidTronic, make sure you have:

  • Windows 10 / 11 โ€” Built for the Windows desktop environment
  • Python 3.8+ โ€” Required to run the engine
  • No admin rights needed โ€” Runs entirely in user space

Install Steps

1

Download the Package

Grab the latest release from the GitHub releases page. The zip file is roughly 20MB. Download

2

Extract to Your Preferred Location

Unzip anywhere โ€” Desktop, Documents, Program Files โ€” it doesn't matter. WidTronic is fully portable.

3

Run the Executable

Double-click widtronic.exe and the widget engine launches immediately. That's it.

WidTronic automatically creates a system tray icon on launch. Right-click it to access settings, change wallpapers, or quit the engine.

Auto-Start on Boot

To have WidTronic launch when Windows starts:

Step 1 โ€” Launch WidTronic

After installation, run widtronic.exe. You'll see the default clock widget on your desktop. The system tray icon (bottom-right) confirms it's running.

Step 2 โ€” Open Settings

Right-click the system tray icon and select "Settings". This opens the configuration panel for widgets, themes, and positions.

Step 3 โ€” Choose Your Widgets

Toggle widgets on/off in the settings panel:

WidgetDescriptionDefault
ClockLarge digital clock with AM/PMOn
DateDay name displayOn
System Monitor (BETA)CPU, RAM, Disk usage barsOff
Weather (BETA)Temperature & conditionOff

Step 4 โ€” Position Widgets

Widgets can be repositioned by:

  • Double-click a widget to enter move mode, then drag
  • Right-click for SETTING menu for options
  • Edit config.json for pixel-perfect positioning

Location

access through
widtronic/ โ”œโ”€โ”€ C:\Users\AppData\Roaming\WidTronic\ โ”œโ”€โ”€ config.json โ† Config file โ”œโ”€โ”€ Fonts/ โ”‚ โ”œโ”€โ”€ TTF/OTF files โ† Custom Fonts โ””โ”€โ”€ assets/ โ† Assest (icons)

Property Reference

PropertyTypeDefaultDescription
themestring"dark-glass"Active theme name
blurnumber20Backdrop blur (0โ€“40)
transparencynumber0.8Widget opacity (0โ€“1)
animationsbooleanfalseTransition animations
positionstring"top-right"Default widget anchor
autostartbooleanfalseLaunch with Windows
log_levelstring"warn""debug"|"info"|"warn"|"error"

Clock Widget

The default and most prominent widget. Large clean typeface with AM/PM.

json
"clock": { "visible": true, "offset_x": 50, "offset_y": 40, "font_size": 52, "font_weight": "light", "show_seconds": false, "24h_format": false }

Date Widget

Displays the current day name. Compact, sits naturally below the clock.

json
"date": { "visible": true, "offset_x": 50, "offset_y": 160, "show_full_date": false }

System Monitor Widget

Beta

Real-time CPU, RAM, and Disk with progress bars. Off by default.

json
"system": { "visible": false, "offset_x": 50, "offset_y": 220, "show_cpu": true, "show_ram": true, "show_disk": true, "refresh_interval": 2 }

Weather Widget

Beta

Fetches weather data and displays temperature, condition, and icon. Requires internet on first load (cached after).

json
"weather": { "visible": false, "offset_x": 50, "offset_y": 340, "units": "celsius", "location": "auto" }

System Monitor adds ~2-3MB RAM. Weather adds ~1-2MB for cached data.

Built-in Themes

ThemeDescriptionBlurTransparency
dark-glassDefault dark translucent glass200.8
lightLight frosted glass300.7

Creating a Custom Theme

Beta

Create a new JSON file in themes/:

json
// themes/my-custom.json { "name": "my-custom", "background": "rgba(10, 10, 20, 0.85)", "text_color": "#ffffff", "accent_color": "#6366f1", "blur": 25, "border_radius": 12, "border_color": "rgba(255, 255, 255, 0.1)" }

Compatibility

  • Wallpaper Engine โ€” Full support, zero conflicts
  • Lively Wallpaper โ€” Full support
  • DesktopHut โ€” Full support
  • Static wallpapers โ€” Naturally supported

Layer Order

text
Layer 0 โ”€ Desktop wallpaper (Wallpaper Engine) Layer 1 โ”€ Desktop icons Layer 2 โ”€ WidTronic widgets โ† renders here Layer 3 โ”€ Application windows Layer 4 โ”€ Taskbar

Performance Impact

ComponentRAMCPU (idle)CPU (active)
Wallpaper Engine~150 MB1-2%3-5%
WidTronic~20 MB0%0.1%
Combined~170 MB1-2%3-5%

WidTronic adds virtually zero overhead on top of Wallpaper Engine. The 20MB RAM is independent and doesn't compound.

Architecture

  • No Electron โ€” No bundled Chromium instance
  • No heavy frameworks โ€” Pure Python with lightweight UI bindings
  • Event-driven updates โ€” Widgets re-render only when data changes
  • No telemetry โ€” Zero background network calls

Memory Breakdown

ComponentMemory
Python runtime~8 MB
UI rendering engine~6 MB
Widget data layer~3 MB
Config & logging~1 MB
System monitoring~2 MB (when enabled)
Total (base)~20 MB

CPU Usage

text
Clock widget: every 1s โ†’ ~0.01% CPU Date widget: every 60s โ†’ ~0.00% CPU System monitor: every 2s โ†’ ~0.05% CPU Weather widget: every 10m โ†’ ~0.00% CPU โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€ Combined idle: ~0.06% CPU

Startup Time

text
Python init: 0.3s Config load: 0.05s Widget setup: 0.15s First render: 0.2s โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€ Total: ~0.7s

If you notice high resource usage, ensure animations are disabled ("animations": false) and system monitor refresh is at least 2 seconds.

General

Is WidTronic safe to use?

Yes. 100% open source Python code. Inspect every file on GitHub. No network calls (except optional weather), no data collection, runs in user space without admin privileges.

What is WidTronic exactly?

A Python-based desktop widget engine. Displays customizable widgets (clock, date, system monitor, weather) directly on your Windows desktop. Ultra-lightweight alternative to Rainmeter.

Why WidTronic over Rainmeter?

Roughly 1/3 the RAM, smaller disk, open source, simpler config via single JSON. Rainmeter has more plugins โ€” WidTronic focuses on doing a few things extremely well.


Technical

Does it work on macOS or Linux?

Windows 10/11 only currently. Widget rendering uses Windows-specific desktop composition APIs. Linux/macOS is on the roadmap.

Can I create custom widgets?

Plugin API for custom widgets is in early development. Currently you can customize existing widgets through config.

Multi-monitor support?

json
"display": { "monitor": 0, "position": "top-right" }

How to completely uninstall?

Delete the WidTronic folder. No registry entries, no AppData, no services. Fully portable.


Troubleshooting

Widgets not showing?

Verify "visible": true in config.json. Check the system tray icon exists. Try running widtronic.exe again.

Config changes not applying?

Validate your JSON (no trailing commas, proper quotes). WidTronic silently ignores invalid config. File watcher has a 1-second debounce.

High CPU usage?

Set "animations": false and increase system monitor "refresh_interval" to 5+ seconds.

Still stuck? Open an issue on GitHub or email yash24k4555@gmail.com