wiki:birdfeeder_app2
Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
wiki:birdfeeder_app2 [2022/10/06 15:17] vizycam [European bird species] |
wiki:birdfeeder_app2 [2022/10/07 16:14] (current) vizycam |
||
|---|---|---|---|
| Line 3: | Line 3: | ||
| ===== Overview ===== | ===== Overview ===== | ||
| - | With this app, Vizy will sit in your backyard and patiently watch your birdfeeder, taking pictures of birds that visit your feeder, identifying their species, and uploading the pictures to the cloud. And it will identify unwanted visitors (e.g. squirrels) and administer a harmless squirt of water (if you like). :-) | + | With this app, Vizy sits in your backyard and patiently watches your birdfeeder, taking pictures of birds that visit your feeder, identifying their species, uploading the pictures to the cloud, and sending you important text updates. And it will identify unwanted visitors (e.g. squirrels) and administer a harmless squirt of water, if you wish. :-) |
| It uses custom convolutional neural networks (CNNs) trained to classify 47 different North American bird species or 40 different European bird species. | It uses custom convolutional neural networks (CNNs) trained to classify 47 different North American bird species or 40 different European bird species. | ||
| - | Additionally, it can be configured to send you a text message and a picture of new bird species that visit your birdfeeder. | ||
| ===== Getting started ===== | ===== Getting started ===== | ||
| - | Begin by turning on your Vizy and pointing your browser to it. (Please refer to the [[wiki:vizy_getting_started|getting started guide]] if you need help with connecting to your Vizy, etc.) Run the Birdfeeder application by clicking on the ☰ icon in the upper right corner and selecting **Apps/Examples**. Then scroll over to Birdfeeder in **Apps**, then click on **Run**. | + | Begin by turning on your Vizy and pointing your browser to it. (Please refer to the [[wiki:vizy_getting_started|getting started guide]] if you need help with connecting to your Vizy, etc.) Run the Birdfeeder application by clicking on the ☰ icon in the upper right corner and selecting **Apps/examples**. Then scroll over to Birdfeeder in **Apps**, then click on **Run**. |
| + | |||
| + | {{wiki:image_1204.jpg?350}} | ||
| The Birdfeeder application takes several seconds to start up. You'll be presented with a screen similar to below. The image at the top of the screen is the live video feed of what Vizy sees (your birdfeeder and its visitors). Various controls (buttons, sliders) are shown below the video feed, which we'll describe in more detail. | The Birdfeeder application takes several seconds to start up. You'll be presented with a screen similar to below. The image at the top of the screen is the live video feed of what Vizy sees (your birdfeeder and its visitors). Various controls (buttons, sliders) are shown below the video feed, which we'll describe in more detail. | ||
| Line 27: | Line 28: | ||
| ==== Media Queue ==== | ==== Media Queue ==== | ||
| - | You'll notice that when detecting birds, Vizy will display the picture of the bird it detected in the media queue as shown. | + | You'll notice that when detecting birds, Vizy will display the picture of the bird it detected and a timestamp in the media queue as shown. |
| {{wiki:image_1200.jpg?700}} | {{wiki:image_1200.jpg?700}} | ||
| - | Vizy will keep track of each bird between frames and do its best to determine when birds first enter the scene and when they have left the scene. When a bird leaves the scene, Vizy will pick a "good" picture and add it to the media queue. This way you can get a quick sense of recent birdfeeder activity by scrolling through the media queue's pictures. In general, each picture represents a different visitor. | + | Vizy keeps track of each bird between frames and does its best to determine when birds first enter the scene and when they have left the scene. When a bird leaves the scene, Vizy will pick a "good" picture and add it to the media queue. This way you can get a quick sense of recent birdfeeder activity by scrolling through the media queue's pictures. In general, each picture represents a different visitor. |
| ===== Controls and Settings ===== | ===== Controls and Settings ===== | ||
| - | At any time you can manually take a picture by clicking on **Take picture**, or take a video by clicking on **Take video**. This will take a picture or video and add it to the media queue. And at any time you can manually defend your birdfeeder by clicking on **Defend**. See the section on [[wiki:birdfeeder_app2#Defense|defense]] below. The **Brightness** slider gives you control over the brightness of the pictures and live video feed. | + | At any time you can manually take a picture by clicking on **Take picture**, or take a video by clicking on **Take video**. This will take a picture or video and add it to the media queue. And at any time you can manually defend your birdfeeder by clicking on **Defend**. See the section on [[#Defense|Defense]] below. The **Brightness** slider gives you control over the brightness of the pictures and live video feed. |
| ==== Settings dialog ==== | ==== Settings dialog ==== | ||
| Line 47: | Line 48: | ||
| * **Pest species**: Check the checkbox of species that you wish to be defended against. Non-birds (squirrels, raccoons, etc.) are considered pest species by default, but you can add other species here if you wish. Note, a given species can be both a species of interest //and// a pest species. | * **Pest species**: Check the checkbox of species that you wish to be defended against. Non-birds (squirrels, raccoons, etc.) are considered pest species by default, but you can add other species here if you wish. Note, a given species can be both a species of interest //and// a pest species. | ||
| * **Detection sensitivity**: Increasing the sensitivity will result in more detections, but possibly more false positive detections. Decreasing the sensitivity will result in fewer detections, but possibly more false negative detections. | * **Detection sensitivity**: Increasing the sensitivity will result in more detections, but possibly more false positive detections. Decreasing the sensitivity will result in fewer detections, but possibly more false negative detections. | ||
| - | * **Defense duration**: this control adjusts how long you want to "defend" your birdfeeder each time Vizy detects an unwanted visitor. It controls how long the squirt lasts, for example. See the section on [[wiki:birdfeeder_app2#Defense|defense]] below. | + | * **Defense duration**: this control adjusts how long you want to "defend" your birdfeeder each time Vizy detects an unwanted visitor. It controls how long the squirt lasts, for example. See the section on [[#Defense|Defense]] below. |
| * **Record defense**: Setting this will post the videos of Vizy defending your birdfeeder from unwanted visitors -- you know, so you can make sure that the birdseed you've so generously provided makes it to the intended recipients. | * **Record defense**: Setting this will post the videos of Vizy defending your birdfeeder from unwanted visitors -- you know, so you can make sure that the birdseed you've so generously provided makes it to the intended recipients. | ||
| - | * **Upload to Google Photos**: Check this if you want the media items in the media queue to be uploaded to Google Photos. Google services need to be configured, however. See the section on [[wiki:birdfeeder_app2#Configuring Google services|configuring Google services]]. | + | * **Upload to Google Photos**: Check this if you want the media items in the media queue to be uploaded to Google Photos. Google services need to be configured, however. See the section on [[#Configuring Google services|Configuring Google services]]. |
| - | * **Text new species**: Vizy will keep track of all species it's seen and text you pictures of new species that visit your birdfeeder. See the section on [[wiki:birdfeeder_app2#Configuring texting|configuring texting]]. | + | * **Text new species**: Vizy will keep track of all species it's seen and text you pictures of new species that visit your birdfeeder. See [[wiki:texting|texting]]. |
| ==== Configuring Google services ==== | ==== Configuring Google services ==== | ||
| Line 61: | Line 62: | ||
| ==== Texting ==== | ==== Texting ==== | ||
| - | Vizy's texting service allows Vizy to send you updates (typically to your phone). For example, Vizy can text pictures of new bird species that visit your birdfeeder ([[wiki:birdfeeder_app2#Settings dialog|see settings]] and the picture below, from the Telegram smartphone app). | + | Vizy's texting service allows Vizy to send you updates (typically to your phone). For example, Vizy can text pictures of new bird species that visit your birdfeeder (see [[#Settings dialog|settings]] and the picture below, from the Telegram smartphone app). |
| {{wiki:img_4224.jpg?300}} | {{wiki:img_4224.jpg?300}} | ||
| - | Or you can ask it to show you pictures of your birdfeeder's most recent visitors ([[wiki:birdfeeder_app2#Text commands|see text commands]]). One of the advantages of texting is that you can interact with your Vizy from practically anywhere as long as your Vizy has a network connection. It's also quick! | + | Or you can ask it to show you pictures of your birdfeeder's most recent visitors see ([[#Text commands|Text commands]] below). One of the advantages of texting is that you can interact with your Vizy from practically anywhere as long as your Vizy has a network connection. It's also quick! |
| - | + | ||
| - | === Configuring texting === | + | |
| - | + | ||
| - | You will need to [[wiki:texting|set up texting]] to take advantage of this feature. Don't worry though -- it's easy, and it's totally free. 8-) | + | |
| === Text commands === | === Text commands === | ||
| Line 81: | Line 78: | ||
| {{wiki:img_4223.jpg?300}} | {{wiki:img_4223.jpg?300}} | ||
| + | Videos that you take or "defense videos" are supported by **mrm** as well. | ||
| ===== Customizations, tweaks, etc. ===== | ===== Customizations, tweaks, etc. ===== | ||
| Line 86: | Line 84: | ||
| ==== Deploying Vizy ==== | ==== Deploying Vizy ==== | ||
| - | You can either have Vizy sitting outside, next to your birdfeeder, all comfy and cozy in an [[wiki:outdoor_enclosure_getting_started|outdoor enclosure]], or you can point Vizy at your birdfeeder through a window, possibly using a [[wiki:zoom_getting_started|zoom lens]]. In general, you want Vizy to be able to see a good amount of detail of the birds -- the birds should occupy about 20% of the image. If they occupy 10% of the image or less, much of the detail will be lost, and Vizy may not be able to reliably identify them. | + | You can either have Vizy sitting outside, next to your birdfeeder, all comfy and cozy in an [[wiki:outdoor_enclosure_getting_started|outdoor enclosure]], or you can point Vizy at your birdfeeder through a window, possibly using a [[wiki:zoom_getting_started|zoom lens]]. In general, you want Vizy to be able to see a good amount of detail of the birds -- the birds should occupy about 20% of the image. If they occupy much less than 10% of the image, much of the detail will be lost, and Vizy may not be able to reliably identify them. |
| This [[wiki:simple_outdoor_enclosure_mounting|guide ]] describes how to mount your Vizy outdoor enclosure. | This [[wiki:simple_outdoor_enclosure_mounting|guide ]] describes how to mount your Vizy outdoor enclosure. | ||
| Line 110: | Line 108: | ||
| - | ==== Handlers ==== | + | ==== Customized handlers ==== |
| For more advanced users who want to add their own custom features, the Birdfeeder application has handler code for various events and for text messages. The handler code is in ''/home/pi/vizy/apps/birdfeeder/handlers.py''. Note, you can bring up the handler code easily from [[wiki:vizy_editor#Text editor|Vizy's built-in text editor]] by clicking on the ☰ button in the text editor and selecting ''handlers.py''. Note also, once you change ''handlers.py'' you can simply click reload/refresh on your browser and Vizy will automatically restart the application and your code changes will take effect. | For more advanced users who want to add their own custom features, the Birdfeeder application has handler code for various events and for text messages. The handler code is in ''/home/pi/vizy/apps/birdfeeder/handlers.py''. Note, you can bring up the handler code easily from [[wiki:vizy_editor#Text editor|Vizy's built-in text editor]] by clicking on the ☰ button in the text editor and selecting ''handlers.py''. Note also, once you change ''handlers.py'' you can simply click reload/refresh on your browser and Vizy will automatically restart the application and your code changes will take effect. | ||
wiki/birdfeeder_app2.1665087474.txt.gz · Last modified: 2022/10/06 15:17 by vizycam
Page Tools
Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
