Overview
SimpleProjector is a cross-platform desktop application designed to make projection simple, elegant, and reliable. Built with Electron, React, and TypeScript, it's perfect for presentations, digital signage, classrooms, events, and any situation where you need to put content on a screen without fighting the tooling.
What's New
Core Features
File Management
- Drag & Drop Support: Easily add images, PDFs, and videos by dragging them into the app
- Thumbnail Previews: Quick visual identification of your content
- Sortable File List: Drag and drop to reorder files in your playlist
- File Removal: Remove unwanted files from your playlist
- Multi-format Support: Mix different file types in a single session
Projector View
- Dedicated Projector Window: Borderless window optimized for external displays and projectors
- Fullscreen Mode: Option to launch in fullscreen for distraction-free projection
- Private Main Screen: Keep your main screen private while projecting
- Smooth Navigation: Seamless transitions between files
- Real-time Sync: Main window and projector stay synchronized
PDF Support
- Full PDF Rendering: Powered by PDF.js for reliable document display
- Page Navigation: Navigate through multi-page PDFs with ease
- Pre-rendered Pages: Pages are converted to images for instant projection
- High Quality: Rendered at 2x scale for crisp, clear display
- Multi-page Documents: Support for documents of any length
Video Playback
- Video Controls: Full playback controls for video files
- Play/Pause: Control video playback from the main window
- Volume Control: Adjust volume with mute/unmute functionality
- Progress Tracking: See video progress and seek to specific times
- Auto-play Option: Automatically play videos when they appear
Playback Controls
- Auto-advance Timer: Automatically move to the next file after a set time
- Loop Mode: Continuously loop through your playlist
- Random/Shuffle Mode: Randomize playback order (requires loop enabled)
- Manual Navigation: Previous/Next buttons for manual control
- Play/Pause: Control the entire playlist playback
Visual Customization
- Background Colors: Customize the projector background color
- Background Images: Set custom background images
- Background Display Options: Choose whether to show background with files
- Transition Effects: Multiple transition types available:
- None
- Fade
- Slide
- Zoom
- Blur
- Rotate
Project Management
- Export Projects: Save your current playlist and settings to a single file
- Import Projects: Load previously saved projects
- Share Configurations: Easily share setups between machines
- Quick Setup: Restore your projection setup in seconds
Settings & Configuration
- Comprehensive Settings Panel: Extensive customization options
- Startup Options:
- Boot on system startup
- Launch in projector mode automatically
- Configure window state on launch (minimized/normal)
- Exit Behavior: Choose to minimize to tray or close completely
- Welcome Dialog: Toggle the welcome dialog on projector launch
- Exit Prompt: Configure whether to show exit confirmation
Technical Highlights
- Cross-platform: Windows, macOS, and Linux support
- Modern Stack: Built with Electron 39.2.3, React 19.2.0, and TypeScript
- Clean Architecture: Follows SOLID principles and clean architecture patterns
- Modern UI: Beautiful interface built with Tailwind CSS
- Responsive Design: Works seamlessly across different screen sizes
- Accessible: Designed with accessibility in mind
Supported File Types
- Images: All standard image formats (JPEG, PNG, GIF, WebP, BMP, etc.)
- Documents: PDF files with full multi-page support
- Videos: All standard video formats supported by Electron's Chromium engine
Installation
Windows
- Download
SimpleProjector-1.0.0 Setup.exefrom the releases page - Run the installer and follow the setup wizard
- The app will be installed and ready to use
Linux
- Debian/Ubuntu: Install
simpleprojector_1.0.0_amd64.debusing your package manager - Fedora/RHEL: Install
SimpleProjector-1.0.0-1.x86_64.rpmusingdnforyum
Getting Started
- Launch SimpleProjector from your applications or desktop
- Add Files: Drag and drop your files (images, PDFs, videos) into the app
- Organize: Reorder files by dragging them in the list
- Configure (optional): Click the Settings icon to customize behavior
- Project: Click "Open Projector" to start projecting
- Control: Use the controls to navigate, play/pause, or adjust volume
Known Limitations
- Video format support depends on Electron's built-in codec support
- Large PDF files may take some time to render initially
- Some advanced video codecs may require system codecs to be installed
Contributing
Very welcome to contributions!
I'm fairly new to the open source community, so I'm open to any suggestions or changes!
Acknowledgments
Built with amazing open-source tools:
- Electron - Cross-platform desktop framework
- React - UI library
- PDF.js - PDF rendering
- Tailwind CSS - Utility-first CSS framework
- Lucide Icons - Beautiful icon set
License
This project is released under the MIT License. See the LICENSE file for details.
Download: GitHub Releases
Documentation: README.md
Report Issues: GitHub Issues