Everything you need to set up Aluleth Video, the free private video player for WordPress, and its add-on Aluleth Video Pro: encrypted streaming, Bunny Stream, Cloudflare Stream and Mux, a watermark with the viewer’s name, a device limit, layers and email forms, playlists and courses, pay per view and analytics.
Contents
- Requirements
- Installation
- Updates
- First steps
- Where a video comes from
- Protected files
- Nginx and large files
- Who may watch
- The player
- Showing a video
- Statistics
- Pro: encrypted streaming
- Pro: Bunny Stream, Cloudflare Stream and Mux
- Pro: watermark
- Pro: devices playing at once
- Pro: embeds on other sites
- Pro: player extras
- Pro: layers over the video
- Pro: playlists and courses
- Pro: pay per view
- Pro: analytics, contacts and events
- Security and privacy
- Honest limits
- Translating the plugin
- Uninstalling
- Troubleshooting
Requirements
- WordPress 7.0 or newer, PHP 7.4 or newer.
- Protected files: an Apache or LiteSpeed server reads the rule the plugin writes by itself; on Nginx, one rule is added to the server configuration (see Nginx and large files).
- Pro encrypted streaming: ffmpeg on the server and a host that allows background tasks (most VPS and many managed hosts). Without them, use Bunny Stream, Cloudflare Stream or Mux.
Installation
- Download Aluleth Video (free) from its page, then go to Plugins › Add New › Upload Plugin, upload
aluleth-video-x.y.z.zipas it is and activate it. - For Pro, download
aluleth-video-pro-x.y.z.zipfrom My account › Downloads on Aluleth Market (the free plugin is in the same download list), upload it the same way and activate it. - Enter your licence key in Aluleth › Settings › Licences. It turns on the Pro features and one-click updates.
- Open Aluleth › Video.
Updates
With an active licence, new versions of Aluleth Video Pro show in Dashboard › Updates and install in one click. Without one, download the new zip from My account › Downloads and upload it with Replace current with uploaded. Your videos, settings and statistics are kept, and database changes run by themselves.
First steps
- Go to Aluleth › Video › Add a video, give it a title and choose a file of the media library (or paste a YouTube, Vimeo or video address).
- Choose Who may watch, and keep Protect the file of this video ticked for a file you do not want downloaded.
- Save. The screen gives the shortcode of the video, for example
[aluleth_video id="12"]. - In a page, add the Video player block and choose the video, or paste the shortcode.
- In Aluleth › Video › Settings, click Check the protected folder once.
Where a video comes from
- A video or audio file of the media library: MP4 (H.264 and AAC) plays everywhere; WebM, MOV, MP3, M4A and OGG work too. Upload large files with the media library, or by FTP and a media plugin.
- A YouTube or Vimeo video: paste its address. The player of the platform loads only when someone presses play (YouTube’s privacy-enhanced address, Vimeo with “do not track”), and the picture of the video is copied into your media library when you save, so the page asks nothing from these platforms before the click.
- The address of a video file or of an HLS stream (.m3u8): it plays in every browser, also those without native HLS.
- Pro: a video of Bunny Stream, Cloudflare Stream or Mux (see below).
A poster image shows before the video plays. Audio files get a compact player with their cover: a square image looks best.
Protected files
When Protect the file of this video is ticked, the file moves to a protected folder of your uploads, with a random name. The page holds no address of it: when someone presses play, the player asks for a short-lived link, given only to a person allowed to watch and tied to their browser. The link does not work in a new tab, from another site or once it has expired; after a long pause the player asks for a new one by itself.
- A link to a protected file works for (Settings › Protection): 240 minutes by default.
- No right-click menu on the player removes “Save video as”.
- The attachment page of a protected file and its entry in the REST API are hidden from people who cannot edit it.
- Only files of the media library can be protected. Untick the box to move the file back to its usual place.
Nginx and large files
Apache and LiteSpeed read the .htaccess file that closes the protected folder. Nginx does not: copy the Rule for Nginx shown in Settings › Protection into your site’s Nginx configuration (or ask your host), then click Check the protected folder. The check says whether the folder can still be opened from the web.
Who sends the files: by default WordPress sends protected files in pieces of 4 MB, which works everywhere. If your host supports it, choose X-Sendfile (Apache with mod_xsendfile, LiteSpeed) or X-Accel-Redirect (Nginx, with the rule): the web server then sends the files itself, faster for large videos.
Who may watch
- Everyone, Logged-in people, People with these roles, or Members of these levels (with Aluleth Membership).
- Pro adds People who bought a product (see Pay per view).
- Text for the others: what people who may not watch see on the player, with a login link. Administrators always see the video.
The player
- Chapters on the progress bar and in a menu: one per line in the video screen, such as
0:33 Lengths and ends. - Subtitles (.vtt files) in several languages, each with its language code and the name shown in the menu.
- Speeds of your choice, picture in picture, full screen, and keyboard shortcuts (space, arrows, M, F, C, 0–9).
- Per video: the shape (wide, square, vertical, cinema), a start time, playing by itself without sound when it comes into view, starting without sound, playing again at the end, and the small player in the corner while the page scrolls.
- In Settings › Look: your accent colour, your logo on the videos (with an optional link) and the speeds of the menu.
Showing a video
Use the Video player block, or the shortcode [aluleth_video id="…"] in any editor, widget or page builder. The page loads only a poster and a play button; the player is built when someone presses play.
Statistics
Aluleth › Video › Statistics shows, for a period and for every video or one: views, viewers, watch time, how much of the video is watched on average, views per day, how far people watch (25, 50, 75 and 100 %) and the most watched videos. YouTube and Vimeo views count only the play. No IP address is kept: a viewer is a random id kept by the browser. In Settings › Statistics, turn the counting off or choose how many days views are kept (365 by default).
Pro: encrypted streaming
On a protected file of the media library, tick Encrypted stream (HLS AES-128) and save. Your server cuts the video with ffmpeg into encrypted pieces, in the background: in 1080p, 720p and 480p (the player picks the best for the connection), or in one quality up to 1080p, which is faster to make (Settings › Encrypted streaming). The video screen shows how the encoding goes; the video plays from the protected file until the stream is ready.
- The pieces stay in the protected folder; their key is kept in the database only. The player gets the playlists and the key through short-lived links made for one viewer and one browser, so a downloaded piece cannot be played.
- Once the stream is ready, the original file is no longer sent to the player.
- Settings › Encrypted streaming says whether ffmpeg was found; you can enter its path. About the length of the video or less on a recent server, more for long 1080p videos.
Pro: Bunny Stream, Cloudflare Stream and Mux
Choose A video of Bunny Stream, Cloudflare Stream or Mux, the service, and paste the id of the video or one of its addresses. The service makes the stream on its servers: nothing needs ffmpeg. Set up each service once in Settings › Streaming services:
- Bunny Stream: the CDN host name of the library and, to sign the addresses, the token authentication key of its pull zone.
- Cloudflare Stream: the customer code (from customer-….cloudflarestream.com) and, to sign, a signing key id and its “pem” value.
- Mux: to sign, a signing key id and its private key (base64).
With a signing key, set your videos to “signed” playback in the service: each viewer allowed to watch gets an address that stops working after the link time, and only addresses made by your site play. Keys are kept on your server, never sent to the browser and never shown again once saved. The picture of the video is copied into your media library when you save.
Pro: watermark
In Settings › Watermark, tick Show a moving text over protected videos and write the text for logged-in people and for visitors with the tags {name}, {email}, {login}, {user}, {ip}, {date} and {site}. Choose its size, its opacity (0.05 to 0.8) and how often it moves. On each video, the watermark follows the settings, or is on or off. A screen recording then carries who made it; the text is put back if someone removes it from the page.
Pro: devices playing at once
Set the most devices of one account playing protected videos at the same time (0 = no limit), and what happens when one more device starts a video: it is refused, or it plays, and the oldest device stops. It stops shared accounts. Administrators have no limit; a device is free again two minutes after its video stops.
Pro: embeds on other sites
In Settings › Embeds on other sites, list the sites allowed to show your videos in a frame, one per line (for example academy.example.com). Every other site is refused by the browser. On each video, tick Can be embedded on the sites allowed in Settings and copy the code to paste on these sites. Videos for logged-in people or members only show their text in a frame, as browsers do not send the login of your site to other sites.
Pro: player extras
- Start again where each person stopped: kept in the browser for visitors, and on the site for logged-in people, on every device.
- Stop at a time (m:ss) on each video.
- Still watching? after some minutes without a click (0 = never).
- Quality menu for streams with several qualities, and A-B loop: press A at the start, B at the end, A again to stop.
- Transcript under the video, made from the first subtitles, with search: a click on a line goes to that moment.
- Timeline previews, small pictures over the progress bar, made by ffmpeg on your server for files of the media library, or from Mux. These small pictures are in the uploads folder and can be opened by anyone who finds their address.
Pro: layers over the video
In the video screen, Layers over the video › Add a layer: a Button with a link, a Text or an Email form, shown from one time until another (or the end), in one of seven places.
- A button can open its link in a new tab.
- An email form can pause the video until it is sent, allow skipping it, ask for the first name and show a consent box for emails.
- Emails become contacts in Aluleth › Contacts (and in Aluleth CRM when it is installed), with the tag you choose; when the consent box is ticked, the contact is subscribed.
Pro: playlists and courses
In Aluleth › Video › Playlists, add a playlist, tick its videos and give their position. Show it with the Video playlist block or its shortcode [aluleth_playlist id="…"]: the videos in order beside the player or under it, and the next one at the end if you choose so.
Set the kind to Course to count the lessons each person finished (“2 of 6 done”). With Course: open the lessons one after the other, a lesson opens when the one before was watched to the end. Progress is kept for logged-in people; the team always sees every lesson.
Pro: pay per view
Set Who may watch to People who bought a product and choose one or more products of WooCommerce, Aluleth Commerce or FluentCart. A paid order of the account counts; refunded orders do not. Buyers must be logged in to watch. The others see “This video comes with a purchase”, a Buy access button (to the product, or to the buy link you give) and a login link.
Pro: analytics, contacts and events
- On each video, the Still watching curve shows the share of views still watching at each point of the video: a steep drop shows where people leave.
- The logged-in viewers of a video, with their views, watch time and how far they went, and a CSV download of the views.
- Settings › Contacts and events: tag logged-in people who watched a video (at 25 to 100 % of it), and who finish a course. Tags “Watched: …” and “Course done: …” and an event in their history go to the contact of the person in Aluleth › Contacts, for Aluleth CRM and Aluleth Insights.
Security and privacy
The plugin keeps, for each view: the video, a hash of a random id kept by the browser, the user id when logged in, the page, the kind of device, the seconds watched and the furthest point. No IP address. Protected videos use a session cookie (alvid_s). With a device limit, the site keeps for each logged-in user, for two minutes, a random id of each browser playing a protected video. The watermark shows the chosen details to the person watching only; they are not stored. The views of a logged-in user can be exported and erased with the WordPress privacy tools, and a suggested text is added to Settings › Privacy.
Honest limits
No web player can stop a screen recording: the watermark is there to trace it. A protected file stops easy downloads, but a very determined person with the right tools can still capture what plays on their screen. Encrypted streaming needs ffmpeg and background tasks on your server; otherwise use a streaming service.
Translating the plugin
English and French are included in full. The POT files are in the languages/ folder of each plugin: translate them with Loco Translate or Poedit.
Uninstalling
Deactivating keeps everything. When Aluleth Video is deleted, the files of protected videos always go back to the usual uploads folder, so your media library keeps working. The videos, settings and statistics are deleted only if you chose it in Aluleth › Settings › When you delete a plugin. Deleting Pro always removes the encrypted streams, the service keys and the device records; the Pro settings go too when you chose it.
Troubleshooting
- The protected folder can be opened from the web: your server does not read .htaccess files (Nginx?). Add the rule shown in Settings › Protection, then check again.
- A protected video does not play: check that the person may watch it, and that the page is not served from a cache to logged-in people.
- Large files play slowly: choose X-Sendfile or X-Accel-Redirect in Settings › Protection if your host supports it, or use encrypted streaming or a streaming service.
- “ffmpeg is not available on this server”: ask your host for ffmpeg, enter its path in Settings › Encrypted streaming, or use Bunny Stream, Cloudflare Stream or Mux.
- A service video does not play: with a signing key, the video must be set to signed playback in the service, and the key id and key must belong to the same account.
- Embedded videos show only their text: the video is for logged-in people or members; browsers do not send your site’s login to other sites.