Skip to content

Commit

Permalink
📄📝 adds configuration information to readme
Browse files Browse the repository at this point in the history
  • Loading branch information
chriamue committed Jan 1, 2024
1 parent bc6b3b9 commit c5bd877
Show file tree
Hide file tree
Showing 2 changed files with 33 additions and 1 deletion.
2 changes: 1 addition & 1 deletion LICENSE
Original file line number Diff line number Diff line change
@@ -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
Expand Down
32 changes: 32 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down Expand Up @@ -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:
Expand Down

0 comments on commit c5bd877

Please sign in to comment.