Skip to content

maykbrito/mini-video-me

Repository files navigation

Mini Video Me

A small webcam player focused on providing an easy way to add and control your webcam during recordings.


Features

  • 👨‍🚀 Shortcuts
  • ⚙️ Highly configurable
  • 💅 Themes and custom themes
  • 🚀 Cross-platform (Windows, Mac, Linux)
  • 🌎 Languages and custom languages (i18n)

Sample preview running the app showing Diego Fernandes happy on the app screen with Visual Studio Code open in the background

Installation

⚠️ For MacOS, move the extracted app to the Applications folder, open your terminal and run the following command to sign the app

codesign --force --deep --sign - /Applications/Mini\ Video\ Me.app

Wait until the command finishes, then open the app and allow the camera permissions asked you. 🚀

Usage & settings

After running for the first time you can access the app settings through the tray menu and click on Settings to change default shortcuts, camera size, zoom, shapes, themes, languages etc.

Default shortcuts

⚠️ For Linux/Windows users: if you're not new to Mini Video Me, you'll probably need to update the shortcuts manually. For this, open the camera settings in tray menu > Settings and update it with the new default shortcuts or others that you like, and the operating system allows, or just select Reset Settings.

MacOS Linux / Windows Function Window must be focused
+ / - + / - Zoom in/out Yes
/ / Flip horizontal Yes
o o Toggle custom shapes Yes
r r Reset zoom Yes
Backspace Backspace Switch cam Yes
Space Space Toggle window size (small/large) Yes
Command + , Ctrl + , Open the settings file Yes
Arrow Up / Down / Left / Right Arrow Up / Down / Left / Right Adjust video offset Yes
Command + Shift + Alt + Up Shift + Alt + Up Move camera to upper screen edge No
Command + Shift + Alt + Down Shift + Alt + Down Move camera to lower screen edge No
Command + Shift + Alt + Right Shift + Alt + Right Move camera to right screen edge No
Command + Shift + Alt + 1 Shift + Alt + 1 Toggle camera size (small/large) No
Command + Shift + Alt + 3 Shift + Alt + 2 Toggle camera visibility (show/hide) No

Adjusting the border

Open the camera settings in tray menu > Settings, then look for "themeOverrides" and change "borderWith" property to "0" if you should to remove the border. Or you can make it thick by changing the value above to "10px" for example.

Using custom shapes

You can use custom shapes using the clip-path CSS property. You can use a tool like Clippy to play around with different shapes you can build with clip-path.

How to add/remove shapes

Open the camera settings in tray menu > Settings and in the "shapes" property, place the CSS's clip-path value as you wish.

See this image example

Change size

Open the camera settings in tray menu > Settings and change "screen.initial" and/or "screen.large"'s width and height properties as you wish

See this image example

Contributing

Clone de repository, open its folder and install dependencies with:

yarn

Run it using:

yarn dev

Author

👤 Mayk Brito

Show your support

Give a ⭐️ if this project helped you!