Added basic Readme.md
This commit is contained in:
parent
1f4043ba06
commit
b369ab561c
1 changed files with 37 additions and 0 deletions
37
Readme.md
Normal file
37
Readme.md
Normal file
|
@ -0,0 +1,37 @@
|
|||
## Instilation
|
||||
|
||||
First, clone the repository:
|
||||
|
||||
git clone *insert url* && cd *insert name of project*
|
||||
|
||||
Create a python virtual environment, and use pip to install the project dependencies:
|
||||
|
||||
python -m venv venv && source venv/bin/activate && pip install -r requirements.txt
|
||||
|
||||
You will need to create a file at `resources/data.json` with the following structure:
|
||||
|
||||
{
|
||||
"stream_url":"https://your.url.here",
|
||||
"user_name":"admin",
|
||||
"stream_key":"your_stream_key_here"
|
||||
}
|
||||
|
||||
Please note, the credentials use for the app are due to change to a utilization of your server's API access token functionality.
|
||||
|
||||
## Using the plugin
|
||||
|
||||
First, source the virtual environment:
|
||||
|
||||
source venv/bin/activate
|
||||
|
||||
Next, run the flask app:
|
||||
|
||||
flask run
|
||||
|
||||
This will start a webserver which can be accessed, by default, at http://127.0.0.1:5000/. This webapp is what you should point an OBS custom browser dock too. Note, check the [flask documentation](https://flask.palletsprojects.com/en/2.2.x/cli/#setting-command-options) for more on how to set specific ports for the webapp.
|
||||
|
||||
Next, using OBS, select Docks from the top bar, and find the Custom Browser Docks option. In the subsequent dialog, point a line item at the aforementioned address and port combination (http://127.0.0.1:5000/). This should embed the webapp within OBS.
|
||||
|
||||
## Final Considerations
|
||||
|
||||
Please note that as of 08-05-2022, this project is a simple proof of concept and has limited functionality. It should provide just enough to provide the base functionality that a streamer dock requires - displaying the current viewers and stream details, and enabling the streamer to update the stream title and tags from the streaming platform (i.e, OBS).
|
Loading…
Reference in a new issue