SimpCity Fullscreen Media Viewer

A seamless fullscreen viewer for browsing media content on simpcity.cr with keyboard navigation and automatic page loading.

Features

• Fullscreen Media Viewing - View images and videos in a distraction-free fullscreen mode
• Keyboard Navigation - Use arrow keys to quickly browse through all media
• Auto-Detection - Automatically finds all images and videos on the page
• High-Quality Loading - Attempts to load highest quality versions of images
• Auto-Load Next Pages - Automatically fetches content from next pages as you browse
• Preloading - Preloads upcoming media for smooth, instant navigation
• Video Support - Full video playback with play/pause controls

Installation

1. Install Python 3.8 or higher
2. Install dependencies:

   pip install -r requirements.txt

3. Install Playwright browsers:

   playwright install chromium

Usage

Run the script:

python simpcity_viewer.py

This will open a Chromium browser window. Navigate to any thread on simpcity.cr, then use the keyboard shortcuts below.

Keyboard Controls

Key	Action
F	Open fullscreen viewer
← / →	Previous / Next media
↑ / ↓	Jump 10 items back / forward
Space	Play/Pause video
Esc	Close viewer

How It Works

1. The script launches a browser with custom JavaScript injected
2. On any page, it scans for all images and videos
3. Media items are numbered and made clickable
4. Press F to enter fullscreen mode
5. Navigate through all media with arrow keys
6. When you're near the end, it automatically loads the next page
7. Continue browsing seamlessly through all pages

Tips for Best Experience

• Log in first - If the site requires login, do so in the browser window
• Navigate to threads - The viewer works best on individual thread pages
• Click numbers - You can click the numbered badges on images to jump directly to that item
• Use jump navigation - Press ↑/↓ to skip 10 items at a time for long threads

Troubleshooting

Browser doesn't open

Make sure you've installed Playwright browsers:

playwright install chromium

No media found

• Make sure you're on a thread page with actual images/videos
• Some content may require scrolling down first
• The page might need to fully load

Images not loading

• Some external hosts may block direct access
• The script tries multiple URL patterns to find the highest quality version

License

MIT License