Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/maykbrito/mini-video-me
📹 A small webcam player focused on providing an easy way to add and control your webcam during recordings.
https://github.com/maykbrito/mini-video-me
default-shortcuts mini-video webcam webcam-player
Last synced: about 1 month ago
JSON representation
📹 A small webcam player focused on providing an easy way to add and control your webcam during recordings.
- Host: GitHub
- URL: https://github.com/maykbrito/mini-video-me
- Owner: maykbrito
- License: mit
- Created: 2020-09-06T00:34:55.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2023-02-09T20:25:16.000Z (almost 2 years ago)
- Last Synced: 2024-10-01T14:01:35.228Z (about 1 month ago)
- Topics: default-shortcuts, mini-video, webcam, webcam-player
- Language: TypeScript
- Homepage: https://maykbrito.github.io/mini-video-me/
- Size: 1.59 MB
- Stars: 1,552
- Watchers: 25
- Forks: 152
- Open Issues: 25
-
Metadata Files:
- Readme: README.md
- License: LICENSE
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.
# Features
- 👨🚀 Shortcuts
- ⚙️ Highly configurable
- 💅 Themes and custom themes
- 🚀 Cross-platform (Windows, Mac, Linux)
- 🌎 Languages and custom languages (i18n)
# 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!