Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://maykbrito.github.io/mini-video-me/

📹 A small webcam player focused on providing an easy way to add and control your webcam during recordings.
https://maykbrito.github.io/mini-video-me/

default-shortcuts mini-video webcam webcam-player

Last synced: about 2 months ago
JSON representation

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

Awesome Lists containing this project

README

        



Mini Video Me


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




releases url




License: MIT



Twitter: maykbrito


# 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

- [Download](https://github.com/maykbrito/mini-video-me/releases)

⚠️ **For MacOS**, move the extracted app to the **Applications** folder, open your terminal and run the following command to sign the app
```bash
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`](https://developer.mozilla.org/en-US/docs/Web/CSS/clip-path)
CSS property. You can use a tool like [Clippy](https://bennettfeely.com/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:

```sh
yarn
```

Run it using:

```sh
yarn dev
```

# Author

👤 **Mayk Brito**

- Twitter: [@maykbrito](https://twitter.com/maykbrito)
- Github: [@maykbrito](https://github.com/maykbrito)
- LinkedIn: [@maykbrito](https://linkedin.com/in/maykbrito)

## Show your support

Give a ⭐️ if this project helped you!