https://github.com/zmira/abremir.vlpause

VLPause for VLC - automatic pause of video being played
https://github.com/zmira/abremir.vlpause

lua vlc-extension

Last synced: about 2 months ago
JSON representation

VLPause for VLC - automatic pause of video being played

• Host: GitHub
• URL: https://github.com/zmira/abremir.vlpause
• Owner: zmira
• License: mit
• Created: 2024-09-21T00:29:19.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2025-04-04T23:17:21.000Z (about 1 year ago)
• Last Synced: 2025-12-30T18:01:35.382Z (6 months ago)
• Topics: lua, vlc-extension
• Language: Lua
• Homepage:
• Size: 1.1 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# VLPause for VLC

![VLPause](./assets/VLPause.webp)

Automatic pause of video being played.

## Description

This Lua extension for VLC allows the currently playing video to automatically pause a number of times, with a `-- INTERMISSION --` message on screen.

The number of times the video will pause for intermission can be calculated or manually entered. This is defined in the VLPause configuration window.

![VLPause configuration](./assets/VLPause_Configuration.png)

* **Total time**: the total time of the current video

* **Calculated # of intermissions**: the calculated number of intermissions for the currently playing video

  * will be re-calculated on every start of play

  * the calculated number of intermissions will be (this is a simple algorithm that fits my needs, no science behind this!)

    * for videos less than 1h15m, 0 intermissions

    * otherwise, number of hours in `duration - 1h15m` plus 1

* **Auto-apply calculated # of intermissions**: when checked, only the calculated number of intermissions will always be used (disregarding the value entered in `# of intermissions`)

* **\# of intermissions**: number of intermissions manually entered (will only be used if the aut-apply checkbox is not checked)

* **Intermission message**: message to be displayed on intermission

## Installation

Copy the [VLPause_ext.lua](./source/VLPause_ext.lua) and [VLPause_intf.lua](./source/VLPause_intf.lua) files to the following folders (depends on your OS) :

* `VLPause_ext.lua` (installation directory `lua/extensions`)

  * Windows (all users): %ProgramFiles%\VideoLAN\VLC\lua\extensions\

  * Windows (current user): %APPDATA%\VLC\lua\extensions\

  * Linux (all users): /usr/lib/vlc/lua/extensions/

  * Linux (current user): ~/.local/share/vlc/lua/extensions/

  * Mac OS X (all users): /Applications/VLC.app/Contents/MacOS/share/lua/extensions/

  * Mac OS X (current user): /Users/%your_name%/Library/Application Support/org.videolan.vlc/lua/extensions/

* `VLPause_intf.lua` (instalation directory `lua/intf`)

  * Windows (all users): %ProgramFiles%\VideoLAN\VLC\lua\intf\

  * Windows (current user): %APPDATA%\VLC\lua\intf\

  * Linux (all users): /usr/lib/vlc/lua/intf/

  * Linux (current user): ~/.local/share/vlc/lua/intf/

  * Mac OS X (all users): /Applications/VLC.app/Contents/MacOS/share/lua/intf/

  * Mac OS X (current user): /Users/%your_name%/Library/Application Support/org.videolan.vlc/lua/intf/

NOTE: Create directories if they do not exist!

Or, take the zip file in the release assets and unzip into the Lua directory.

## Changelog

* 0.8

  * always display intermission message at start, even if rewound to the start

* 0.7

  * allow customization of intermission message

* 0.6

  * replace static dropdown to select the number of intermissions with text input to allow manual entry

* 0.5

  * replace "automatic skip intermission if suggested is zero" with "auto-apply suggested number of intermissions"

  * calculate suggested number of intermissions instead of relying on a static mapping table

  * refactor loop function to re-calculate variables when input URI changes

  * display number of planned intermissions on start of play

* 0.4

  * allow automatic skip intermission if suggested number of intermissions is zero [obsolete v0.5]

* 0.3

  * allows selection of number of intermissions, up to 5 equal length chunks [obsolete v0.6]

  * add suggested number of intermissions based on duration of input

  * other cosmetic changes

* 0.2

  * fix issue when running on a brand new install of vlc

* 0.1

  * initial version with pausing only at 50% duration of playing item [obsolete v0.3]

## Acknowledgements

* 

* 

* [Lua reference manual](https://www.lua.org/manual/5.4/contents.html#contents)

* [Programming in Lua (first edition)](https://www.lua.org/pil/contents.html)

* [Time v3.2](https://addons.videolan.org/p/1154032/) (c) lubozle

* lua-users wiki - [String Recipes](http://lua-users.org/wiki/StringRecipes)

* [How to dump a table to console?](https://stackoverflow.com/a/27028488/552219)

* [LUA script](https://luascripts.com/)

* [Lua compiler](https://onecompiler.com/lua)

* [Run  lua in the browser](https://glot.io/new/lua)

* [Big Buck Bunny](https://www.bigbuckbunny.org) (c) copyright 2008, Blender Foundation / www.bigbuckbunny.org