Browse Source

update contributing docs

Jason Hunter 4 years ago
parent
commit
3a171d19e3
1 changed files with 11 additions and 1 deletions
  1. 11 1
      docs/docs/contributing.md

+ 11 - 1
docs/docs/contributing.md

@@ -41,12 +41,15 @@ Fork [blakeblackshear/frigate-hass-integration](https://github.com/blakeblackshe
 ### Setup
 ### Setup
 
 
 #### 1. Build the docker container locally with the appropriate make command
 #### 1. Build the docker container locally with the appropriate make command
+
 For x86 machines, use `make amd64_frigate`
 For x86 machines, use `make amd64_frigate`
 
 
 #### 2. Create a local config file for testing
 #### 2. Create a local config file for testing
+
 Place the file at `config/config.yml` in the root of the repo.
 Place the file at `config/config.yml` in the root of the repo.
 
 
 Here is an example, but modify for your needs:
 Here is an example, but modify for your needs:
+
 ```yaml
 ```yaml
 mqtt:
 mqtt:
   host: mqtt
   host: mqtt
@@ -69,15 +72,22 @@ cameras:
 These input args tell ffmpeg to read the mp4 file in an infinite loop. You can use any valid ffmpeg input here.
 These input args tell ffmpeg to read the mp4 file in an infinite loop. You can use any valid ffmpeg input here.
 
 
 #### 3. Gather some mp4 files for testing
 #### 3. Gather some mp4 files for testing
+
 Create and place these files in a `debug` folder in the root of the repo. This is also where clips and recordings will be created if you enable them in your test config. Update your config from step 2 above to point at the right file. You can check the `docker-compose.yml` file in the repo to see how the volumes are mapped.
 Create and place these files in a `debug` folder in the root of the repo. This is also where clips and recordings will be created if you enable them in your test config. Update your config from step 2 above to point at the right file. You can check the `docker-compose.yml` file in the repo to see how the volumes are mapped.
 
 
 #### 4. Open the repo with Visual Studio Code
 #### 4. Open the repo with Visual Studio Code
+
 Upon opening, you should be prompted to open the project in a remote container. This will build a container on top of the base frigate container with all the development dependencies installed. This ensures everyone uses a consistent development environment without the need to install any dependencies on your host machine.
 Upon opening, you should be prompted to open the project in a remote container. This will build a container on top of the base frigate container with all the development dependencies installed. This ensures everyone uses a consistent development environment without the need to install any dependencies on your host machine.
 
 
 #### 5. Run frigate from the command line
 #### 5. Run frigate from the command line
-VSCode will start the docker compose file for you and you will be able to see 3 containers listed when running `docker ps`. To run frigate with your modified code, run `docker exec -it frigate /bin/bash` from the command line to get a prompt inside the container. Then run `python3 -m frigate` to start.
+
+VSCode will start the docker compose file for you and open a terminal window connected to `frigate-dev`.
+
+- Run `python3 -m frigate` to start the backend.
+- In a separate terminal window inside VS Code, change into the `web` directory and run `npm install && npm start` to start the frontend.
 
 
 #### 6. Teardown
 #### 6. Teardown
+
 After closing VSCode, you may still have containers running. To close everything down, just run `docker-compose down -v` to cleanup all containers.
 After closing VSCode, you may still have containers running. To close everything down, just run `docker-compose down -v` to cleanup all containers.
 
 
 ## Web Interface
 ## Web Interface