From c5bd87724b69692d922b51c04e6e68370bffcca2 Mon Sep 17 00:00:00 2001 From: Christian M Date: Mon, 1 Jan 2024 16:23:45 +0100 Subject: [PATCH] :page_facing_up::memo: adds configuration information to readme --- LICENSE | 2 +- README.md | 32 ++++++++++++++++++++++++++++++++ 2 files changed, 33 insertions(+), 1 deletion(-) diff --git a/LICENSE b/LICENSE index 06b09a8..f93ead3 100644 --- a/LICENSE +++ b/LICENSE @@ -1,6 +1,6 @@ MIT License -Copyright (c) 2022 Christian M +Copyright (c) 2022-2024 Christian M Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal diff --git a/README.md b/README.md index 548e76d..1f2afa9 100644 --- a/README.md +++ b/README.md @@ -4,6 +4,12 @@ OrnithologyPi is a Rust-based project that captures and analyzes a video stream ![Overview](https://www.plantuml.com/plantuml/proxy?cache=no&src=https://raw.githubusercontent.com/chriamue/ornithology-pi/main/docs/overview.puml) +## ⚠️ State of Development + +The project is currently in the early stages of development. The development is done from time to time. +The project is not yet ready for production use. +I am working on many dependencies that will take some time to complete. + ## 🎥 How It Works 1. **Capture Stream**: Utilizes a webcam to capture a live video stream. @@ -155,6 +161,32 @@ To enable the service on boot: sudo systemctl enable ornithology-pi ``` +## Configuration + +The configuration file is located at `config.toml`. + +### Example + +```toml +[default.shutdown] +ctrlc = false +signals = ["term", "hup"] + +[default.camera] +device = "0" +width = 640 +height = 480 +fps = 30 + +[default.server] +port = 8000 +address = "0.0.0.0" +``` + +The device for camera is optional and must be a number. If no device is specified, the first available device will be used. + +I had sometimes problems with camera configurations that are not supported by the camera. If you have problems with the camera, try to change the configuration of width, height, and fps. + ## 🛠️ Using the Makefile For ease of use, OrnithologyPi includes a `Makefile` that automates various tasks, allowing you to focus on development without worrying about the underlying commands. Below are the available make commands and their descriptions: