RaspiCam is a react application to stream, take pictures or record videos from your raspberry pi camera over a web interface.
- Simple: a mobile-first designed user interface to provide a flawless user experience on the smartphone.
- Lightweight: raspiCam uses the build-in libcamera-still and libcamera-vid to stream, capture and record videos.
- Share your configuration with results
- Monitoring camera
- Timelapse photography
- Video recorder
- Camera to go with trigger (GPIO button or smartphone)
- Use it as a tool to find the best camera settings for your project.
- Adjust the settings without manually start and stop the libcamera-vid or libcamera-still.
- Copy the result from the terminal and use it for your project.
- MJPEG stream
- for external applications like octoprint
- alternative for devices without media source extension
- http://ip_address:8000/api/stream/mjpeg
I'm using a Raspberry PI Zero W with a Raspberry PI HQ camera.
You can find the 3d printing files on https://www.prusaprinters.org/prints/48519-raspberry-pi-zero-webcam-hq-camera
If you prefer a Raspberry PI4: https://www.prusaprinters.org/prints/61556-raspberry-pi4-hq-camera-aluminium-mix
From version >1.2.0, raspiCam support the libcamera apps of the new Raspberry Pi OS. If you use an older version with raspistill and raspivid, please check version 1.2.0 in the release section.
If your raspberry is already up and running, you can skip this section and continue with the "Install Node.js" section.
Install the latest Raspberry Pi OS Lite with the Raspberry PI imager. Feel free to use the desktop version, but it's not necessary for the application.
Usefull links:
After the installation, make sure your system is up to date:
sudo apt update
sudo apt upgrade
Enable the NodeSource repository by running the following command in your terminal:
curl -sL https://deb.nodesource.com/setup_18.x | sudo bash -
sudo apt install nodejs
The latest versions of node don't provide an official armv6l version. Thanks to https://unofficial-builds.nodejs.org we can still use newer node versions.
wget https://unofficial-builds.nodejs.org/download/release/v18.9.1/node-v18.9.1-linux-armv6l.tar.gz
tar -xzf node-v18.9.1-linux-armv6l.tar.gz
sudo cp -r node-v18.9.1-linux-armv6l/* /usr/local
sudo reboot
To verify the installation, run the following command to print the installed node version.
node --version
Download the latest release and extract it to a new raspiCam folder.
mkdir raspiCam && cd raspiCam
wget https://github.com/Lillifee/raspiCam/releases/latest/download/raspiCam.tar.gz
tar -xvzf raspiCam.tar.gz
Alternative: Clone the repository and build it
Clone the repository and build the package:git clone https://github.com/Lillifee/raspiCam.git
cd raspiCam/
npm install
npm run build
The bundled package should appear in the build folder.
exiv2 is used to extract the thumbnails from the photos.
sudo apt install exiv2
(optional) onoff to access the GPIO features. Switch to the raspiCam folder and run:
npm install onoff
Change to the raspiCam or build folder and start the server:
node server.js
As soon the server is up and running, the following message appear:
[server] server listening on 8000
Open the browser and navigate to: http://__ip_address__:8000
-p or --port 80 - server port (default 8000) -c or --CORs true - allow CORs during development (default true)
To automatically start the RaspiCam on startup, you can run the RaspiCam as a service. Download the raspicam.service from the the repository:
wget https://raw.githubusercontent.com/Lillifee/raspiCam/master/systemd/raspicam.service
Change the working directory and user details in a text editor like nano or vi if raspicam is stored elsewhere or if a different user is being used.
WorkingDirectory=/home/pi/raspiCam
User=pi
Copy the raspicam.service file to the systemd:
sudo cp raspicam.service /etc/systemd/system
Enable and start the raspicam service:
sudo systemctl enable raspicam.service
sudo systemctl start raspicam.service
If you encounter problems (e.g.: the server doesn't start), check the logs:
journalctl -u raspicam
Or stop and disable the service:
sudo systemctl disable raspicam.service
sudo systemctl stop raspicam.service
RaspiCam supports triggering an image/video using a GPIO pin.
Not all GPIO pins are suitable to use as a capture trigger. I would suggest starting with a GPIO pin without additional usage like GPIO 17, 27 22, etc.
The onoff library is used to access the GPIO pins. Check the site for wiring information or how to configure the GPIO pins to pull-up/pull-down resistors in the /boot/config.txt if needed. https://github.com/fivdi/onoff
You can also check the following article to run the raspiCam headless. It includes a step by step instruction for:
Slow live stream
- Check the WIFI connection
- Close the web developer tools
- Increase the quality compensation in the settings
Found a bug? Don't hesitate to create a new issue.
Please add your running setting to the ticket. You can find the latest command sent to raspiCam in the terminal output:
HINT If you found the right settings for your project, you can simple copy the command from there.
- Search settings
- Setting explanation
- group timelapse photos
- download multiple items (zip)
jmuxer web application raspberry hq camera software react live player node.js raspberry pi stream h264 monitoring timelapse video recording capture libcamera-vid libcamera-still libcamera-app bullseye raspicam