Full-featured media assistant
SimpCity Media Assistant
Please Do Whatever You Want With This Code
Warning: Due to its image preloading behavior, this script may generate a high number of image requests in a short period of time. Users on limited connections or low-memory systems should use caution when enabling it on large threads.
SimpCity Media Assistant is a Tampermonkey userscript that enhances image-heavy threads on simpcity by adding advanced media controls, automatic image handling, smooth auto-scrolling, and a fullscreen gallery viewer. It transforms standard forum browsing into a cleaner, faster, and more gallery-focused experience while remaining entirely client-side.
Floating Control Panel
The script adds a draggable and resizable floating control panel that stays above all page content. This panel acts as the central hub for all features and remembers its size and screen position between sessions using persistent storage.
Image Preloading and Splash Screen
All post images are forced to load immediately at full resolution, bypassing lazy loading and thumbnail variants. While images are loading, a fullscreen splash screen is displayed showing a live counter of loaded images, preventing layout shifts and partially rendered threads.
Automatic Post Content Expansion
Any forum elements labeled “Click to expand” are automatically opened as they appear. This works both on initial page load and on dynamically injected content, ensuring all hidden media and text are visible without manual interaction.
Auto-Scroll System
The script provides an automatic scrolling feature that can be toggled on or off at any time. Scroll speed is adjustable, direction can be set to up or down, and all settings persist between page loads. Auto-scrolling automatically pauses when opening images or when a page navigation is detected.
Global Image Visibility Controls
Users can hide all images for text-only and video browsing, show all images again instantly, expand every image to full size, or collapse all expanded images. These controls operate across the entire page and intelligently manage conflicting states to avoid layout issues.
Per-Post Image Controls
Each post receives its own image toggle buttons placed at both the top and bottom of the post. These buttons expand or collapse only the images contained within that specific post and automatically update their labels based on the current image state.
Fullscreen Gallery Viewer
Clicking any image opens a fullscreen overlay that displays the image at full resolution. The viewer allows navigation through every image on the page in sequence and includes an on-screen image counter showing the current position within the gallery.
Zoom and Pan Interaction
Within the fullscreen viewer, images can be zoomed using the mouse wheel with zoom centered on the cursor position. Click-and-drag panning allows precise movement of zoomed images, with smooth scaling and enforced zoom limits.
Keyboard and On-Screen Navigation
The gallery viewer supports keyboard navigation using the arrow keys, escape key to close, and on-screen navigation arrows. A dedicated close button is also provided for mouse-only interaction.
Dynamic Image Tracking
The script continuously tracks images added to the page as new posts load. Event listeners are applied safely without duplication, ensuring that gallery navigation and image interaction remain consistent throughout dynamic content updates.
Page Change Detection
Dynamic page changes are detected automatically. When a thread or page changes without a full reload, auto-scrolling is safely disabled to prevent unintended scrolling behavior.
Persistent User Settings
User preferences such as auto-scroll state, scroll speed, scroll direction, and control panel layout are saved using Tampermonkey storage and restored automatically on future visits.
Fully Client-Side Operation
All functionality runs entirely within the browser. The script makes no external network requests, performs no data collection, and does not interact with user accounts or posting behavior.
