Decision Wheel Spinner

WHAT IT DOES

Decision Wheel Spinner helps you make random decisions by spinning a colorful wheel of options. Add your own choices—anything from "Yes" and "No" to a list of activities, names, or items. Spin the wheel and watch it animate before landing on a random option. You can assign weights to options to make some more likely to be selected. The tool tracks your spin history so you can see past results. Add, edit, and remove options at any time. The wheel updates in real time with a visual display showing all options in colored segments.

WHERE IT RUNS

The extension runs entirely within your browser's local environment using the BotGentz framework. All wheel rendering, animation, and selection occur on your machine without any network requests. No decision data, option history, or user activity is ever transmitted, uploaded, or stored externally. The tool works on any website and respects the browser's security boundaries, operating within the isolated extension sandbox. The wheel uses the HTML5 Canvas API for rendering and animation.

HOW TO USE

Click the extension toolbar icon to open the Decision Wheel Spinner panel. The wheel displays your current options as colored segments. To add an option, type it in the "Add option" field and click "Add"—the wheel updates immediately. Click the "✎" button next to any option to edit it. Click the "✕" button to remove an option. Click "Spin!" to spin the wheel—it animates and lands on a random option. The selected option is displayed and added to the history. Click "Reset Wheel" to return the wheel to its default state. Toggle "Enable weights" to assign different probabilities to options. Toggle "Show history" to display previous spin results. Toggle "Sound effects" to enable audio feedback during spins. Adjust the "Spin duration" (1000-8000ms) to control how long the wheel spins. Use "Clear All" to remove all options and "Clear History" to clear the history list.

THE WHEEL ANIMATION ENGINE — WHY IT WORKS

Most decision wheels use simple random selection without visual feedback. This tool combines canvas-based rendering with smooth animation for a satisfying experience. The wheel is drawn using the Canvas API with pie slices for each option. Each slice's angle is proportional to its weight, creating a visually accurate representation of probabilities. The animation engine uses requestAnimationFrame with an easing function (ease-out cubic) to create a realistic spinning deceleration effect. The wheel rotates through multiple full rotations before stopping at the selected segment. The selection is made before the animation starts by calculating a weighted random index, then the animation stops at the corresponding segment. The colors are pre-assigned from a palette and cycle through options consistently. This approach provides a visually engaging, interactive decision-making experience.

THE PANEL

The Decision Wheel Spinner panel is fully draggable by its title bar and remembers its position on screen per website. It snaps to the edges of your browser window for clean alignment. Collapse the panel to a compact icon strip using the minimize button, restoring it with a single click. Resize the panel by dragging any edge or corner; the wheel canvas, option list, and controls adjust proportionally. Press the Escape key to close the panel instantly. The panel maintains independent state for each browser tab, allowing you to run multiple wheels in different tabs simultaneously.

PLEASE NOTE

This extension requires the free BotGentz extension framework to be installed and enabled. The wheel is rendered using Canvas; very large numbers of options (30+) may make segments difficult to read. Weights are relative and normalized automatically—if one option has weight 2 and another has weight 1, it's twice as likely to be selected. The history is stored in memory and cleared when the page is refreshed. Sound effects require user interaction with the page first (due to browser autoplay policies). All wheel data is processed locally and is never transmitted, logged, or shared. The extension requests no network permissions and functions entirely offline. The source code is fully auditable and available for review.