Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

History

6 Commits

Repository files navigation

🎬 VidPlus – Highly Customizable Embed Player for Movies, TV Shows, and Anime

Your ultimate destination for movies, TV shows, and anime. Stream your favorites with our advanced customizable player.

📋 Table of Contents


🌐 Base Endpoints

Movies

https://player.vidplus.to/embed/movie/{tmdbId}

TV Shows

https://player.vidplus.to/embed/tv/{tmdbId}/{season}/{episode}

Anime

https://player.vidplus.to/embed/anime/{anilistId}/{episode}?dub={true/false}

📊 Content Types

Content TypeSourceID FormatRequired Paths
MoviesThe Movie Database (TMDB)TMDB ID{tmdbId}
TV ShowsThe Movie Database (TMDB)TMDB ID{tmdbId}/{season}/{episode}
AnimeAniListAniList ID{anilistId}/{episode}

⚙️ Player Parameters

🎮 Playback Controls

ParameterTypeDefaultDescriptionExample
autoplaybooleantrueAuto-start playbackautoplay=true
autonextbooleantrueAuto-play next episode (TV/Anime only)autonext=false
nextbuttonbooleantrueShow next episode button (TV/Anime only)nextbutton=true
progressnumber-Start position in secondsprogress=600 (10 minutes)

🎨 Visual Customization

ParameterTypeDefaultDescriptionExample
primarycolorhex6C63FFPrimary player color (sliders, controls)primarycolor=B20710
secondarycolorhex9F9BFFProgress bar background colorsecondarycolor=170000
iconcolorhexFFFFFFPlayer icon colorsiconcolor=B20710
posterbooleantrueShow poster/thumbnailposter=false
titlebooleantrueShow content titletitle=true

🎭 Icon & UI Settings

ParameterTypeDefaultDescriptionExample
iconsstringdefaultIcon style: default, netflix, vid, lucide, tbicons=netflix
servericonbooleantrueShow server selection iconservericon=false
settingbooleantrueShow settings iconsetting=true
pipbooleantrueShow picture-in-picture iconpip=false

📺 Content Features

ParameterTypeDefaultDescriptionExample
episodelistbooleantrueShow episode list (TV/Anime only)episodelist=false
chromecastbooleantrueEnable Chromecast supportchromecast=false
watchpartybooleanfalseEnable WatchParty featurewatchparty=true
downloadboolean-Enable download functionalitydownload=true

📝 Subtitle & Font Settings

ParameterTypeDefaultDescriptionExample
fontstringRobotoFont familyfont=Poppins
fontcolorhexFFFFFFFont/subtitle colorfontcolor=FFFF00
fontsizenumber20Font size in pixelsfontsize=24
opacitynumber0.5Font background opacity (0-1)opacity=0.8

🔗 Advanced Settings

ParameterTypeDefaultDescriptionExample
logourlurlNetflix logoCustom logo URLlogourl=https://example.com/logo.png
dubbooleanfalseDub version for animedub=true
serverstring-Server name or number (server name recommended)server=minecloud or server=3

🚫 Hide Controls (UI Cleanup)

ParameterTypeDescriptionExample
hideprimarycolorbooleanHide primary color controlhideprimarycolor=true
hidesecondarycolorbooleanHide secondary color controlhidesecondarycolor=true
hideiconcolorbooleanHide icon color controlhideiconcolor=true
hideprogresscontrolbooleanHide progress controlhideprogresscontrol=true
hideiconsetbooleanHide icon style controlhideiconset=true
hideautonextbooleanHide auto-next controlhideautonext=true
hideautoplaybooleanHide autoplay controlhideautoplay=true
hidenextbuttonbooleanHide next button controlhidenextbutton=true
hideposterbooleanHide poster controlhideposter=true
hidetitlebooleanHide title controlhidetitle=true
hidechromecastbooleanHide Chromecast controlhidechromecast=true
hideepisodelistbooleanHide episode list controlhideepisodelist=true
hideservericonbooleanHide server icon controlhideservericon=true
hidepipbooleanHide PIP controlhidepip=true

💡 Examples

🎬 Basic Movie Embed

<iframesrc="https://player.vidplus.to/embed/movie/78692" frameborder="0" allowfullscreen></iframe>

📺 TV Show with Custom Colors

<iframesrc="https://player.vidplus.to/embed/tv/94997/1/1?primarycolor=B20710&secondarycolor=170000&iconcolor=FFFFFF" frameborder="0" allowfullscreen></iframe>

🎌 Anime with Dub

<iframesrc="https://player.vidplus.to/embed/anime/21/1?dub=true&autoplay=false" frameborder="0" allowfullscreen></iframe>

🎨 Fully Customized Player

<iframesrc="https://player.vidplus.to/embed/movie/597?autoplay=true&primarycolor=FF6B6B&secondarycolor=4ECDC4&iconcolor=FFFFFF&poster=true&title=true&chromecast=true&icons=netflix&font=Poppins&fontcolor=FFFFFF&fontsize=20&opacity=0.8&logourl=https://example.com/logo.png" frameborder="0" allowfullscreen></iframe>

🖥️ With Custom Server

<iframesrc="https://player.vidplus.to/embed/movie/597?server=minecloud&autoplay=true&primarycolor=6C63FF" frameborder="0" allowfullscreen></iframe>

🎯 Minimal UI (Cinema Mode)

<iframesrc="https://player.vidplus.to/embed/movie/597?hideposter=true&hidetitle=true&hidechromecast=true&hidepip=true&hideepisodelist=true&hideservericon=true" frameborder="0" allowfullscreen></iframe>

🎪 WatchParty Enabled

<iframesrc="https://player.vidplus.to/embed/tv/94997/1/1?watchparty=true&autoplay=true&chromecast=true" frameborder="0" allowfullscreen></iframe>

🔧 Advanced Features

🎨 Color Format

  • Use hex colors without# prefix
  • Colors are automatically converted to uppercase
  • Example: #FF0000 becomes primarycolor=FF0000

📱 Responsive Design

  • Player automatically adapts to container size
  • Maintains aspect ratio on all devices
  • Touch-friendly controls on mobile

🔒 Security Features

  • HTTPS-only embedding
  • CORS-protected API
  • Rate limiting protection

📊 Performance Optimization

  • Lazy loading support
  • Adaptive bitrate streaming
  • CDN-powered delivery

🚀 Quick Start Guide

  1. Get your content ID from TMDB (movies/shows) or AniList (anime)
  2. Choose your base endpoint based on content type
  3. Add customization parameters as needed
  4. Embed using iframe with proper attributes

Example Workflow:

// 1. Get TMDB ID for "Inception" (movie ID: 27205)// 2. Build URL with customizationsconstplayerUrl="https://player.vidplus.to/embed/movie/27205"+"?autoplay=true"+"&primarycolor=00D4FF"+"&secondarycolor=0099CC"+"&poster=true"+"&title=true";// 3. Embed in your sitedocument.getElementById('player').innerHTML=`<iframe src="${playerUrl}" frameborder="0" allowfullscreen></iframe>`;

📞 Support & Resources

🌐 Official Links

WebsiteDiscordTelegram

📊 API Information

  • API Status: Always online with 99.9% uptime
  • Content Sources: TMDB for movies/shows, AniList for anime
  • Update Frequency: Real-time content updates

This documentation covers all available parameters and features of the VidPlus Player API. For the most up-to-date information, visit our official website.

About

Highly Customizable Embed Player for Movies, TV Shows, and Anime

Topics

Resources

Stars

8 stars

Watchers

0 watching

Forks

Contributors