CustomTV

📺 CustomTV - Play Your Own Videos on the TV

Ever wanted to hijack the TV and play your own videos? Now you can.

🧩 Features

• ✅ Full MP4 playback support using Unity's built-in Video Player
• ✅ Multi-Video support
• ✅ Manual pause/resume & previous/skip controls via hotkeys
• ✅ Automatically plays next video
• ✅ Shuffles video list on mod load.
• ✅ Play YouTube videos directly from URLs
• ✅ Video caching system for YouTube videos to improve performance
• ✅ Automatic management of temporary files
• ✅ Ability to use signs as TVs by inputting the word "customtv" onto them

⌨️ Controls

While holding Shift + Ctrl:

• - or Numpad Minus → Pause video
• + or Numpad Plus → Resume video
• ] → Skip video
• [ → Previous video
• Right Arrow → Seek Forwards (10 seconds by default)
• Left Arrow → Seek Backwards (10 seconds by default)
• V → Paste YouTube URL from clipboard

📁 How to Install

1. Make sure you have Melon Loader installed for Schedule I.
2. Drop the appropriate CustomTV.dll into your Mods folder:

• Use CustomTV.IL2CPP.dll for the main/none and beta versions
• Use CustomTV.Mono.dll for the Steam alternate and alternate-beta versions

1. Create a folder called TV inside Mods if it doesn't exist.
2. Place your mp4 files inside Mods/TV.

 📁 Schedule I
  └── 📁 Mods
       ├── 📄 CustomTV.IL2CPP.dll (or CustomTV.Mono.dll)
       └── 📁 TV
            └── 📄 example.mp4

🧪 Compatibility

Game Versions:

• IL2CPP (main version of Schedule I)
• Mono (alternate version available through Steam beta branch)

Framework: Melon Loader

⚙️ Configuration

You can tweak the keybinds and adjust the audio volume to your liking through the MelonPreferences.cfg file:

1. Where to Find the Config File

The configuration settings are now stored in the default MelonPreferences.cfg file in your game's UserData directory, not in a separate CustomTVConfig.ini file.

1. Config Example (in MelonPreferences.cfg):

; Valid key names: https://docs.unity3d.com/ScriptReference/KeyCode.html

[CustomTV]
PauseKey = "Minus"
ResumeKey = "Equals"
NextVideoKey = "RightBracket"
PreviousVideoKey = "LeftBracket"
SeekForwardKey = "RightArrow"
SeekBackwardKey = "LeftArrow"
VolumePercent = 100
SeekAmount = 10.0
Shuffle = true
YoutubeURLKey = "V"
MaxCachedYoutubeVideos = 25
DeleteYoutubeVideosOnExit = true
UseFirefoxCookies = false
signSize = "(3, 2.2, 0)"

You still must press both Ctrl and Shift before the set keybind. Note: Valid key names can be found in the Unity KeyCode Enum Reference

🔀 CustomTV Sorting Guide

If shuffle mode is disabled, CustomTV sorts your video files in a specific order to keep episodes and seasons in a logical sequence. To ensure your videos are sorted correctly, follow these simple naming rules:

Recommended Naming Format:

1. Season and Episode Numbers First

Name your video files starting with the season and episode numbers, formatted as SxxExx. Example: S01E01 - ShowName.mp4

1. Optional Leading Numbers

If you have files with a leading number (like special episodes, bonuses, or collections), place the number at the start of the file name. Example: 001 - SpecialEpisode.mp4 or 10 - BonusEpisode.mp4

1. Natural Sorting

After following the above formats, CustomTV will handle sorting your files in a natural order as usually displayed in file explorer (e.g., S01E01 will come before S01E10).

Important Notes:

• **Season and episode number (SxxExx)** is the most important for sorting.
• Leading numbers are used for episodes or specials outside the main series.
• Files will be ordered by season first, then episode number, then any numbers at the start of the filename.

By following these simple naming conventions, CustomTV will automatically sort your episodes in a way that makes sense for watching!

🎥 YouTube Functionality

The mod now supports playing videos directly from YouTube URLs.

How to use:

1. Download yt-dlp and place it in your TV/yt-dlp folder
2. Copy a YouTube URL to your clipboard
3. Press Ctrl+Shift+V in-game to paste and process the URL
4. The video will be downloaded and played on the TV

Configuration

You can configure the following YouTube-related settings in the MelonPreferences.cfg file:

• Youtube URL = V - The key to paste YouTube URL from clipboard (default: V)
• Max Cached Youtube Videos = 25 - Number of YouTube videos to keep cached (default: 25)
• Delete Youtube Videos On Exit = True - Whether to delete cached videos when the game exits (default: True)

❓ FAQ

Q: Can I use .webm or other formats? A: No, Unity's VideoPlayer works best with .mp4 (H.264/AAC).

Q: The screen is black/frozen! A: Make sure your video has the mp4 extension and uses a supported codec.

Q: Keybinds aren't working. A: Be sure to press both ctrl and shift before the keybind, for example ctrl-shift-] to skip video.

🎉 Credits

• Created by Jumble
• YouTube & Mono functionality added by IfBars