2020-09-04 23:43:39 -04:00
|
|
|
# VirtPlay
|
2020-10-17 17:58:23 -04:00
|
|
|
VirtPlay is a bash script to automate playing video or audio files over a fake PulseAudio microphone and/or fake v4l2loopback webcam.
|
2020-09-04 23:43:39 -04:00
|
|
|
|
|
|
|
|
## Depends
|
|
|
|
|
- [ffmpeg](https://ffmpeg.org/)
|
|
|
|
|
- [v4l2loopback](https://github.com/umlaeute/v4l2loopback)
|
|
|
|
|
|
|
|
|
|
## Installation
|
|
|
|
|
- Clone this repository
|
|
|
|
|
- Ensure that ~/.local/bin is in your PATH
|
|
|
|
|
- Copy virtplay to ~/.local/bin
|
|
|
|
|
|
|
|
|
|
## Options
|
|
|
|
|
| **Option** | **Default** | **Description** |
|
|
|
|
|
|------------------------|--------------------------|---------------------------------------------------------------------------------|
|
|
|
|
|
| `-r` `--resolution` | `1920x1080` | Changes the resolution of the fake webcam |
|
|
|
|
|
| `-f` `--fps` | `30` | Changes the frame rate of the fake webcam |
|
|
|
|
|
| `-b` `--border` | `true` | Enables/disables changing the input video's aspect ratio to fit the fake webcam |
|
|
|
|
|
| `-l` `--loopback` | `true` | Enables/disables playing the virtual microphone through your speakers |
|
|
|
|
|
| `-ar` `--audio-rate` | `44100` | Changes the audio sampling rate of the fake microphone |
|
|
|
|
|
| `-c` `--channels` | `1` | Changes the number of audio channels the fake microphone has |
|
|
|
|
|
| `-ao` `--audio-only` | `false` | Only uses the fake microphone |
|
|
|
|
|
| `-vo` `--video-only` | `false` | Only uses the fake webcam |
|
|
|
|
|
| `-vd` `--video-device` | `/dev/video0` | Changes which v4l2loopback device to use |
|
2021-04-09 15:03:40 -04:00
|
|
|
| `-ad` `--audio-device` | `VirtPlay` | Changes the name of the fake microphone |
|
2020-09-04 23:43:39 -04:00
|
|
|
| `-bf` `--buffer-file` | `/tmp/virtplay` | Changes the path that the stdin buffer file is created at |
|
|
|
|
|
| `-t` `--timestamp` | `0` | Jumps play head to timestamp in either seconds or [HH:]MM:SS[.m...] |
|
|
|
|
|
| `-v` `--volume` | `1` | Sets the volume 0-1, where 0 is 0% and 1 is 100% |
|
|
|
|
|
| `-h` `--help` | | Displays a help message |
|
