Added basic Readme.md
This commit is contained in:
parent
1f4043ba06
commit
018b624f19
1 changed files with 39 additions and 0 deletions
39
Readme.md
Normal file
39
Readme.md
Normal file
|
@ -0,0 +1,39 @@
|
||||||
|
## Instilation
|
||||||
|
|
||||||
|
First, clone the repository:
|
||||||
|
|
||||||
|
git clone https://gitdab.com/arianagiroux/DockOfOurOwn.git && cd DockOfOurOwn
|
||||||
|
|
||||||
|
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).
|
||||||
|
|
||||||
|
This project is still a pretty rough product, as these docs likely illustrate. Unfortunately, I have little time to dedicate to development time so I welcome any contributions, updates, forks, etc. This was simply a means to an end for me.
|
Loading…
Reference in a new issue