home-assistant.io/source/_integrations/rpi_camera.markdown
Bram Kragten 630f456aed
Merge current into next (#40176)
Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: ecspiegel <87676266+ecspiegel@users.noreply.github.com>
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
Co-authored-by: alawadhi3000 <5523980+alawadhi3000@users.noreply.github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Franck Nijhof <git@frenck.dev>
Co-authored-by: Marcel van der Veldt <m.vanderveldt@outlook.com>
Co-authored-by: staticdev <staticdev-support@proton.me>
Co-authored-by: tronikos <tronikos@users.noreply.github.com>
Co-authored-by: AlCalzone <dominic.griesel@nabucasa.com>
Co-authored-by: Martin Hjelmare <marhje52@gmail.com>
Co-authored-by: essys <essys@users.noreply.github.com>
Co-authored-by: Abílio Costa <abmantis@users.noreply.github.com>
Co-authored-by: Gord <31004434+googanhiem@users.noreply.github.com>
Co-authored-by: Darren Griffin <darren.griffin@live.co.uk>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: hanwg <han.wuguang@gmail.com>
Co-authored-by: Adam W <35391288+A-damW@users.noreply.github.com>
Co-authored-by: Hessel <hesselonline@users.noreply.github.com>
Co-authored-by: Damien Sorel <mistic@strangeplanet.fr>
Co-authored-by: Tempura San <tempura.san@gmail.com>
Co-authored-by: Manu <4445816+tr4nt0r@users.noreply.github.com>
Co-authored-by: J. Diego Rodríguez Royo <jdrr1998@hotmail.com>
Co-authored-by: lexitus <38081592+lexitus@users.noreply.github.com>
Co-authored-by: Sid <27780930+autinerd@users.noreply.github.com>
Co-authored-by: Evgeny Sureev <u@litka.ru>
Co-authored-by: Stefan Agner <stefan@agner.ch>
Co-authored-by: TomArm <TomArm@users.noreply.github.com>
Co-authored-by: starkillerOG <starkiller.og@gmail.com>
Co-authored-by: Maciej Bieniek <bieniu@users.noreply.github.com>
Co-authored-by: Guillaume Rischard <github@stereo.lu>
Co-authored-by: Geoff <85890024+Thulrus@users.noreply.github.com>
Co-authored-by: GhoweVege <85890024+GhoweVege@users.noreply.github.com>
Co-authored-by: Logan Rosen <loganrosen@gmail.com>
Co-authored-by: Robert Resch <robert@resch.dev>
Co-authored-by: RanTheLab <RanTheLab@users.noreply.github.com>
Co-authored-by: Jan Bouwhuis <jbouwh@users.noreply.github.com>
Co-authored-by: John Hess <john@h3ss.com>
Co-authored-by: Marco <cdrfun@cdrfun.eu>
Co-authored-by: robthebold <38596885+robthebold@users.noreply.github.com>
Co-authored-by: Paulus Schoutsen <balloob@gmail.com>
Co-authored-by: Pieter Rautenbach <parautenbach@gmail.com>
Co-authored-by: Tsvi Mostovicz <ttmost@gmail.com>
Co-authored-by: Michael <35783820+mib1185@users.noreply.github.com>
Co-authored-by: Joost Lekkerkerker <joostlek@outlook.com>
Co-authored-by: Galorhallen <12990764+Galorhallen@users.noreply.github.com>
Co-authored-by: Jan-Philipp Benecke <jan-philipp@bnck.me>
Co-authored-by: Jan Čermák <sairon@users.noreply.github.com>
Co-authored-by: Norbert Rittel <norbert@rittel.de>
Co-authored-by: Mr. Snyds <41122989+mrsnyds@users.noreply.github.com>
Co-authored-by: Allen Porter <allen.porter@gmail.com>
Co-authored-by: Ludovic BOUÉ <lboue@users.noreply.github.com>
Co-authored-by: threatdisplay <ajbriones@gmail.com>
Co-authored-by: Kamil Breguła <mik-laj@users.noreply.github.com>
Co-authored-by: Simone Chemelli <simone.chemelli@gmail.com>
Co-authored-by: Timothy <6560631+TimoPtr@users.noreply.github.com>
Co-authored-by: Joris Pelgröm <jpelgrom@users.noreply.github.com>
Co-authored-by: Wendelin <12148533+wendevlin@users.noreply.github.com>
Co-authored-by: Arie Catsman <120491684+catsmanac@users.noreply.github.com>
Co-authored-by: Marko Dimjašević <marko@dimjasevic.net>
Co-authored-by: karwosts <32912880+karwosts@users.noreply.github.com>
Co-authored-by: Guido Schmitz <Shutgun@users.noreply.github.com>
2025-07-28 16:45:52 +02:00

3.1 KiB

title, description, ha_category, ha_iot_class, ha_release, ha_domain, ha_platforms, ha_integration_type, related, ha_quality_scale
title description ha_category ha_iot_class ha_release ha_domain ha_platforms ha_integration_type related ha_quality_scale
Raspberry Pi Camera Instructions on how to integrate Raspberry Pi within Home Assistant.
DIY
Local Polling 0.17 rpi_camera
camera
integration
docs title
/docs/configuration/ Configuration file
legacy

The rpi_camera {% term integration %} allows you to integrate the Raspberry Pi camera into Home Assistant. This integration uses the application rpicam-still to store the image from camera.

{% important %} This integration is only available on Home Assistant Core installation types. Unfortunately, it cannot be used with Home Assistant OS, Supervised or Container. {% endimportant %}

Configuration

To enable this camera in your installation, add the following to your {% term "configuration.yaml" %} file. {% include integrations/restart_ha_after_config_inclusion.md %}

# Example configuration.yaml entry
rpi_camera:

The whole set of configuration variables is documented in the Raspberry Pi documentation of the camera software. They are not all wrapped by this rpi_camera platform.

{% configuration %} image_width: description: Set the image width. required: false type: integer default: 640 name: description: Name of the camera. required: false type: string default: Raspberry Pi Camera image_height: description: Set the image height. required: false type: integer default: 480 image_quality: description: Set the image quality (from 0 to 100). required: false type: integer default: 7 image_rotation: description: Set image rotation (0-359). required: false type: integer default: 0 horizontal_flip: description: Set horizontal flip (0 to disable, 1 to enable). required: false type: integer default: 0 vertical_flip: description: Set vertical flip (0 to disable, 1 to enable). required: false type: integer default: 0 timelapse: description: Takes a picture every this many milliseconds (thousands of a second) - the default means one picture a second. required: false type: integer default: 1000 overlay_metadata: description: Adds some text and/or metadata onto the picture. Check the --annotate section. required: false type: integer default: none overlay_timestamp: description: Helper to add date/time onto the picture. Format as used by strftime. required: false type: string default: none file_path: description: Save the picture in a custom file path. required: false type: string default: A temporary file is used. {% endconfiguration %}

The given file_path must be an existing file because the camera platform setup performs a writeable check on it. Also, keep in mind that the path should be whitelisted.