f6e2156ab3
* Fix makefile flags on low memory devices (#124) * Fix `makefile` flags on low memory devices On devices with less than 512MB existing devices will use `-j2` due to wrong condition. * docs: Update index with correct heading and link to backends (#131) This is a follow-up to #108 and fixes heading and hyperlink to the list of backends * Typo in `core.sh` (#138) * Fix makefile flags on low memory devices (#124) (#125) * Fix `makefile` flags on low memory devices On devices with less than 512MB existing devices will use `-j2` due to wrong condition. Co-authored-by: Kamil Trzciński <ayufan@ayufan.eu> * Typo in `core.sh` 'Dependencys' --> dependencies --------- Co-authored-by: Stephan Wendel <43513802+KwadFan@users.noreply.github.com> Co-authored-by: Kamil Trzciński <ayufan@ayufan.eu> * Fix makefile flags on low memory devices (#124) (#125) (#144) * Fix `makefile` flags on low memory devices On devices with less than 512MB existing devices will use `-j2` due to wrong condition. Co-authored-by: Kamil Trzciński <ayufan@ayufan.eu> * docs(messages.sh): fix typos, improve spelling (#145) * feat: add legacy cam support (#146) * feat: add legacy cam support Signed-off-by: Patrick Gehrsitz <58853838+mryel00@users.noreply.github.com> * feat: add blockyfix Signed-off-by: Patrick Gehrsitz <58853838+mryel00@users.noreply.github.com> * fix: add ustreamer legacy cam workaround Signed-off-by: Patrick Gehrsitz <58853838+mryel00@users.noreply.github.com> --------- Signed-off-by: Patrick Gehrsitz <58853838+mryel00@users.noreply.github.com> * Fix makefile flags on low memory devices (#124) (#125) (#147) * Fix `makefile` flags on low memory devices On devices with less than 512MB existing devices will use `-j2` due to wrong condition. Co-authored-by: Kamil Trzciński <ayufan@ayufan.eu> * fix: fix make config empty path (#148) Signed-off-by: Patrick Gehrsitz <58853838+mryel00@users.noreply.github.com> * fix: fix default_path_msg function name (#149) * fix: fix default_path_msg function name Signed-off-by: Patrick Gehrsitz <58853838+mryel00@users.noreply.github.com> * fix: fix message Signed-off-by: Patrick Gehrsitz <58853838+mryel00@users.noreply.github.com> --------- Signed-off-by: Patrick Gehrsitz <58853838+mryel00@users.noreply.github.com> * fix: fix libcamera-apps-lite not getting updated (#160) libcamera-apps-lite is needed for libcamera-hello. Crowsnest uses libcamera-hello to detected raspicams Signed-off-by: Patrick Gehrsitz <58853838+mryel00@users.noreply.github.com> * fix: fix Shellcheck test error (#153) * fix: fix Shellcheck test error Signed-off-by: Patrick Gehrsitz <58853838+mryel00@users.noreply.github.com> * style: remove empty condition Signed-off-by: Patrick Gehrsitz <58853838+mryel00@users.noreply.github.com> --------- Signed-off-by: Patrick Gehrsitz <58853838+mryel00@users.noreply.github.com> * fix: fix CustomPiOS docker build error (#158) This should skip any check of `SUDO_USER` Tested with Win & Linux host with Docker Signed-off-by: Patrick Gehrsitz <58853838+mryel00@users.noreply.github.com> --------- Signed-off-by: Patrick Gehrsitz <58853838+mryel00@users.noreply.github.com> Co-authored-by: Kamil Trzciński <ayufan@ayufan.eu> Co-authored-by: DeviousFusion <dj3tusk@gmail.com> Co-authored-by: Sergei <67871383+slepiavka@users.noreply.github.com> Co-authored-by: Patrick Gehrsitz <58853838+mryel00@users.noreply.github.com>
6.6 KiB
crowsnest
A wrapper script for webcam streaming on Raspberry Pi OS Lite images like MainsailOS. Mainly written in bash.
- Why is it called crowsnest?
- Support
- Documentation
- Compatibility
- Contribute
- How to support us?
- CustomPiOS-module
- What 'Backends' does crowsnest use
- Credits
Why is it called crowsnest?
It inherited his name from sailing ships crow's nest.
A crow's nest is a structure in the upper part of the main mast of a ship or a structure that is used as a lookout point.
See https://en.wikipedia.org/wiki/Crow's_nest
So, this will be the 'lookout point' for your printer.
Support
Please read carefully on how to configure crowsnest to your needs! Check out the FAQ section for first aid or join our Discord server if you need further help. For some topics that are not covered in the documentation, just read below.
PS: Do not open issues that are based on misconfiguration! This makes it harder for me to keep track of problems in my code.
Documentation
We have decided to move crowsnest's documentation to a new location.
Please go to https://crowsnest.mainsail.xyz/
If there is something in our documentation that is not covered, is described in a way that is misunderstood, or simply is missing, please let us know!
Compatibility
Tested on the following distributions:
Legend:
Tested and work as intended: ✔️
Tested and/or did not work: ❌
Should work but not tested: ❓
Not available: ➖
| Operating System | X86 Architecture | ARM Architecture |
|---|---|---|
| Raspberry Pi OS (buster) | ➖ | ❌ (Hint) |
| Raspberry Pi OS (bullseye) | ➖ | ✔️ |
| MainsailOS (<0.7.1) | ➖ | ❌ (Hint) |
| MainsailOS (>1.0.0) | ➖ | ✔️ (rpi) |
| Armbian | ❓ | ✔️ |
| Ubuntu Server 20.04 | ✔️ | ❓ |
| Ubuntu Server 22.04 LTS | ✔️ | ✔️ (rpi) |
| Linux Mint 21 (codename: vanessa) | ✔️ | ❓ |
| Archlinux (and derivatives) | ❌ | ❌ |
| Alpine Linux | ❌ | ❌ |
If you test that on other distributions, feel free to open a Pull Request to enhance documentation.
Hint
OS images that are based on Debian 10 (codename 'buster') are no longer supported with Crowsnest version 4 (current master branch)!
Please use the legacy/v3 branch for these OS types.
See the README.md of this branch for usage instructions.
Contribute
- Create an Issue related to your topic.
- Prepare an tested Pull Request against the
developbranch- Please use commits formatted according to Conventional Commits
- Make sure you do not ignore the code formatting as provided by the .editorconfig of this repo
- Be patient. Every PR has to go through some sort of "internal gates" before it reaches the master branch, unless an immediate response is crucial.
How to support us
Buy KwadFan a coffee at ko-fi.com or support the mainsail project
Please consider hitting the ⭐ button in the upper right hand corner to show some love for this project.
CustomPIOS Module
I have decided to provide a CustomPiOS Module to make it easier to integrate with other distributions like MainsailOS or similar.
Please see README.md in the module folder for more information.
What 'Backends' does crowsnest use?
Please see the according FAQ section in our documentation.
Credits
I want to give a huge shoutout to lixxbox and alexz from the mainsail-crew.
Without these guys it simply were not possible to get that done.
They both mentioned improvements and tested a heck out of there machines to get this all functioning well.
Thank you, mates :) Proud to be a part of.
Thanks to Pedro Lamas, for the ISSUE_TEMPLATES.
Thanks to ayufan for keep going on camera-streamer, even I stressed him to get rid of some bugs ;)
So, with all that said, get your position seaman! Prepare to get wet feets on your journey.