Skip to content

Commit 8bc9078

Browse files
committed
Added setup and example steps in Readme
1 parent d116240 commit 8bc9078

File tree

1 file changed

+34
-1
lines changed

1 file changed

+34
-1
lines changed

README.md

Lines changed: 34 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,36 @@
1-
# spur
1+
# SPUR
22
Simple recorder with webcam overlay
33

4+
## Installation
5+
- Downlaod the spur binary from the latest release.
6+
- Since this project heavily uses gstreamer, whose libraries are dynamically linked, you will have to download the required gstreamer libraries. The following command should work on debian based machines, but you can [refer this article](https://gstreamer.freedesktop.org/documentation/installing/on-linux.html?gi-language=c) for other linux distros
7+
_I have only tested spur on ubuntu so far. But I would be happy to help if you are keen to test it's support on your distro_
8+
9+
```shell
10+
sudo apt-get update
11+
```
12+
```shell
13+
sudo apt-get install libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev libgstreamer-plugins-bad1.0-dev gstreamer1.0-plugins-base gstreamer1.0-plugins-good gstreamer1.0-plugins-bad gstreamer1.0-plugins-ugly gstreamer1.0-libav gstreamer1.0-doc gstreamer1.0-tools gstreamer1.0-x gstreamer1.0-alsa gstreamer1.0-gl gstreamer1.0-gtk3 gstreamer1.0-qt5 gstreamer1.0-pulseaudio
14+
```
15+
16+
17+
- Mark it as executable by running `chmod +x spur` on the binary
18+
- Run the setup `./spur setup`. This sets the directory where the videos will be stored
19+
- Use `./spur -h` or `./spur <command> -h` to see the available options
20+
> **Note:** Currently only supports local recordings. The stream functionality for remote recording is still a WIP
21+
22+
### Example
23+
24+
After running `./spur setup` if there were no errors you can run\
25+
```
26+
./spur record --filename=testRecording
27+
```
28+
Should start the recording while showing you a sticky overlay of your webcam preview.
29+
If you use an external webcam like me, make sure that it is plugged in when you do so, as the program will crash if a camera is not found.
30+
31+
**Once you are done recording, you can stop the recording session by typing `end` into the terminal**
32+
33+
This is better than using `Ctrl + C` and killing the terminal process as that would result in some parts of the recording not being correctly saved.
34+
35+
---
36+
_If you face any problems while trying to run this project, consider raising an issue or reaching out to me directly._ PRs are welcome too😄

0 commit comments

Comments
 (0)