📖 Documentation

Everything you need to know to use Playlist

Getting Started

Installation

  1. Download the latest installer
  2. Run PlaylistSetup.exe
  3. Follow the installation wizard
  4. Launch Playlist from the Start Menu or desktop shortcut

System Requirements:

  • Windows 10 or Windows 11 (64-bit)
  • .NET 9.0 Runtime (included in installer)
  • 2 GB RAM minimum
  • 100 MB disk space

First Launch

When you first open Playlist, you'll see the main window with an empty playlist sidebar. You're ready to create your first playlist!

Managing Playlists

Creating a New Playlist

  1. Click File → New Playlist in the menu bar
  2. Enter a name for your playlist (e.g., "Action Movies", "Workout Music")
  3. Click Add Files/Folders to select media files
  4. Browse and select video or audio files from your computer
  5. Optionally, drag items to reorder them in your preferred sequence
  6. Click Save to create the playlist

Editing an Existing Playlist

  1. Right-click on a playlist in the sidebar
  2. Select Edit from the context menu
  3. Add or remove files as needed
  4. Click Save to apply changes

Note: When editing, the system intelligently preserves your customizations (renamed items, play counts, timestamps) for files that remain in the playlist.

Deleting a Playlist

  1. Right-click on a playlist in the sidebar
  2. Select Remove
  3. Confirm the deletion when prompted

Note: Deleting a playlist does not delete the actual media files from your computer.

Organizing Playlists

Use the hamburger menu (☰) next to the search box to sort playlists:

  • Sort by Name: A-Z or Z-A (default: A-Z)
  • Sort by Created Date: Newest first or Oldest first
  • Sort by Last Played: Most recent first or Longest ago first

Use the search box to quickly find playlists by name.

Playing Media

Starting Playback

There are several ways to start playing media:

  • Double-click an item in the playlist to play from the beginning
  • Right-click → Play: Starts playback from the beginning
  • Right-click → Continue: Resumes from where you last stopped

Media Player Controls

The media player window includes overlay controls that appear when you move your mouse and auto-hide after 3 seconds.

Buttons

  • Play/Pause (▶/⏸): Toggle playback
  • Stop (■): Stop playback and close the player
  • Full Screen (⛶): Toggle full-screen mode

Progress Bar

  • Shows current playback position and total duration
  • Click or drag to seek to any position in the video
  • Displays current time and total duration on either side

Volume Control

  • Drag the volume slider to adjust audio level
  • Volume setting is remembered for future playback

Keyboard Shortcuts

Space Play/Pause
F11 Toggle full-screen mode
Escape Exit full-screen mode or show controls

Full-Screen Mode

Press F11 or click the full-screen button to enter full-screen mode. The Windows taskbar will be hidden for an immersive viewing experience.

To exit full-screen mode:

  • Press Escape
  • Press F11 again
  • Click the exit full-screen button

Managing Playlist Items

Renaming Items

  1. Right-click on an item in the playlist
  2. Select Rename
  3. Enter a custom name (e.g., "Episode 5" instead of "video_5.mp4")
  4. Press Enter to save

Note: This only changes the display name in Playlist, not the actual filename.

Removing Items

  1. Right-click on an item in the playlist
  2. Select Remove
  3. The item is removed from the playlist

Note: This does not delete the file from your computer.

Reordering Items

Click and drag items to rearrange them in your preferred order. The new order is saved automatically.

Viewing History

To view your playback history:

  1. Click File → History
  2. View a chronological list of everything you've watched
  3. Each entry shows the playlist, item name, and when it was played

Supported Formats

Playlist uses VLC media player for playback, which supports a wide variety of formats including:

Video Formats

MP4, MKV, AVI, MOV, WMV, FLV, WEBM, MPEG, MPG, M4V, 3GP, and many more

Audio Formats

MP3, WAV, FLAC, AAC, OGG, WMA, M4A, AIFF, OPUS, and many more

Subtitle Formats

SRT, SUB, ASS, SSA, VTT (automatically detected if in the same folder as the video)

Troubleshooting

Video won't play

  • Ensure the file exists at the original location
  • Check that the file format is supported
  • Try playing the file in VLC media player directly to verify it's not corrupted

Controls not showing

  • Move your mouse over the video window
  • Press Escape to force controls to appear
  • Controls auto-hide after 3 seconds of no mouse movement

Application crashes or errors

  • Errors are automatically logged in the application database
  • Check for updates at the Releases page
  • Report issues on GitHub Issues

Data Storage

All playlist data, settings, and history are stored locally in a SQLite database on your computer. No data is sent to the cloud or any external servers.

Database Location: The database file is stored in the application's data directory.

Backup: To backup your playlists, copy the database file to a safe location. You can restore it later by replacing the file.

Need More Help?

If you need additional assistance or want to report a bug: