Browse tutorials

Sharing and Embedding

Using your videos in Viloud

Copy a video's HLS link and add it to a Viloud channel or playlist, plus what that means for bandwidth, views and privacy.

Vidreno Last updated

On this page
  1. What the HLS link is
  2. Which videos get one
  3. Where to find Copy HLS link
  4. Add the video to Viloud
  5. Put it in a channel or playlist
  6. What to know once it's running
  7. Other players and tools
  8. Related articles

Viloud builds online TV channels and playlists out of videos you already host elsewhere. Instead of uploading the same file twice, you can hand it a direct stream link to the video on Vidreno, and it plays from here. This guide shows you where that link lives, which videos get one, and how to put it into a Viloud channel.

Each public hosted video on a plan with adaptive quality has a direct stream link that ends in .m3u8. It points at the adaptive quality versions Vidreno created for that video, so a player that reads the link can switch between resolutions for each viewer the same way our own player does. The format is called HLS, and it's what Viloud and most channel tools, media players and TV apps accept when they ask for a video URL.

It's a different thing from the other two links on your video page:

Link What it is Use it for
Share The public watch page on vidreno.com Chats, email, social posts. See Sharing a video link
Embed An iframe that drops the Vidreno player onto your site Your own website. See Embedding a video on your website
HLS link The raw stream, with no Vidreno page or player around it Viloud and other third party players and channel tools

Which videos get one

A video has an HLS link when all of these are true:

  • It's a hosted video, not a film sold or rented through On Demand.
  • Your account is on a plan that includes adaptive quality versions (Standard, Premium or Lifetime). See Adaptive quality playback for your videos.
  • Its quality versions are ready. On a paid plan they're created on their own after every upload, so for a new video this is usually a few minutes after the upload finishes.
  • The video is public. A private video is only meant for you, and the stream link would play for anyone holding it, so we don't offer one. See Setting a video to public or private.

There are two places, and they always agree with each other.

  • On the video page. Open one of your videos. In the row of buttons under the player, next to Share and Embed, you'll see Copy HLS link.
  • From your Hosted Videos library. Hover over a video card and click the embed icon (the angle brackets). Below the embed options is a section called Direct stream link (HLS) with the same Copy HLS link button.

When the video is ready, one click puts the link on your clipboard and a small confirmation reminds you how plays through other tools are counted (more on that below). When it isn't ready, the button opens a short note explaining why, with a shortcut where there's something you can do about it:

What the note says What it means What to do
HLS links need adaptive quality Your plan doesn't include quality versions, so there's nothing to stream yet Use the Upgrade button, or see Choosing the right plan for you
No quality versions yet The video was uploaded before your plan included adaptive quality Click Create quality versions. The link appears once they're done
Creating quality versions, with a percentage The versions are still being made Wait a few minutes, then come back. The video already plays on Vidreno meanwhile
Public videos only The video is private Set it to public if you want to stream it elsewhere
No HLS link for this video No stream can be served for this one, for example because the quality versions couldn't be created Nothing to do here. The video still plays normally through Share and Embed

Add the video to Viloud

The names below are the ones Viloud uses today. Their layout changes from time to time, so if a button has moved, the Viloud knowledge base has the current walkthrough.

  1. On Vidreno, click Copy HLS link on the video you want to use.
  2. Sign in to Viloud and open the Content tab.
  3. Paste the link into the add video box and press Enter. Viloud adds it to your content library as an external link. You can give it a tag if you like, which makes it easier to find once the library grows.
  4. Repeat for every Vidreno video you want to use. Each video needs its own link.

Viloud's own page on this is Adding videos to your content, and its supported formats article confirms that external links need to be HLS, which is exactly what Vidreno gives you.

Put it in a channel or playlist

  1. Open the Channels tab and click Create channel (or open a channel you already have).
  2. Pick the kind of channel you want. A Linear channel plays the same thing to everyone at the same time, either Scheduled at fixed times or Looped round the clock. A Playlist channel lets viewers skip between videos on demand.
  3. Give it a name, choose a logo and colour if you want, and accept.
  4. Open the channel and add your Vidreno videos from the content library. In a scheduled channel you drag them onto the time grid; in a looped or playlist channel you add them to the list.
  5. Use Preview to check the channel plays, then Embed to put Viloud's player on your site, or take the channel's own link into a TV app.

You can test a link before you build anything around it. Paste it into Viloud's content library and open the preview, or into any player that accepts an HLS URL such as VLC (Media, then Open Network Stream). If it plays there, it'll play in your channel.

What to know once it's running

Every play through Viloud streams the video from Vidreno, so it counts toward your monthly bandwidth allowance exactly like a play on the watch page or in an embed. A channel that loops a video all day uses bandwidth all day. Keep an eye on the meter on your Billing page, and see Adding more bandwidth to your account if a channel takes off.

Two more things follow from the stream playing outside the Vidreno player:

  • Plays aren't recorded as views. Your analytics only count what happens in our player, so a video that's popular on a Viloud channel won't show it in Reading your analytics dashboard. Viloud has its own statistics for that.
  • Earn and the player banner don't apply. Earn pays for views in the Vidreno player, and the banner lives in that player. Neither exists inside Viloud's player, so plays there don't count toward Earn.

The link itself doesn't expire, so you never need to refresh it in Viloud. What does change it:

  • Deleting the video removes the quality versions with it, and the stream stops right away. Viloud will show the item as unavailable until you remove it from your channel. See Deleting a video.
  • Making the video private takes the Copy HLS link button away, because private is a promise that only you can reach the video. It doesn't recall a link you've already handed out: a channel that has the link keeps playing the stream. If a video needs to come off a Viloud channel for good, remove it from the channel there, or delete it from Vidreno.
  • Moving to the Free plan keeps the quality versions and the link, so an existing channel carries on playing. You can't copy new links until your account is back on a paid plan.

Treat the HLS link like the video itself. Anyone who has it can play the stream, on your bandwidth, without visiting Vidreno. Only paste it into tools you control, and if a link gets somewhere it shouldn't, deleting the video is the one sure way to stop it.

Other players and tools

The link isn't specific to Viloud. Any player or channel builder that accepts an HLS or .m3u8 URL will take it, with the same bandwidth, views and privacy rules described above.

More in Sharing and Embedding

Host and sell video with Vidreno

Start on the Free plan with 50GB of bandwidth a month, move up from $12/mo when you need more, or sell films and courses through Vidreno on Demand at a flat 10% per sale after the payment processor's fee, with no subscription.