Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/AllskyTeam/allsky
A Raspberry Pi operated Wireless Allsky Camera
https://github.com/AllskyTeam/allsky
allsky-camera astronomy open-source raspberry-pi
Last synced: about 2 months ago
JSON representation
A Raspberry Pi operated Wireless Allsky Camera
- Host: GitHub
- URL: https://github.com/AllskyTeam/allsky
- Owner: AllskyTeam
- License: mit
- Created: 2016-10-22T19:41:45.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2024-05-18T00:41:14.000Z (6 months ago)
- Last Synced: 2024-05-19T06:50:30.067Z (6 months ago)
- Topics: allsky-camera, astronomy, open-source, raspberry-pi
- Language: JavaScript
- Size: 127 MB
- Stars: 1,098
- Watchers: 65
- Forks: 172
- Open Issues: 36
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Allsky Camera  [](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=MEBU2KN75G2NG&source=url)
This is the source code for the Allsky Camera project described [on Instructables](http://www.instructables.com/id/Wireless-All-Sky-Camera/).
> **This README and the [Allsky documentation](https://htmlpreview.github.io/?https://raw.githubusercontent.com/thomasjacquin/allsky/master/html/documentation/index.html) will help get your allsky camera up and running.**
## Requirements
You will need the following:
* A Raspberry Pi (Zero 2, 2, 3, 4) running Pi OS.
* A camera (Raspberry Pi HQ, Module 3, or RPi compatible, or ZWO ASI)
> **NOTES:**
> - Only the Raspberry Pi OS is supported (Buster, Bullseye, or Bookworm). Other operating systems like Ubuntu are NOT supported.
> - **NOTE**: support for Buster is going away so please upgrade to Bookworm.
> - The ZWO ASI120-series cameras are not recommended due to somewhat poor quality and tendency to produce timeout errors. See [Troubleshooting --> ZWO Cameras](https://htmlpreview.github.io/?https://raw.githubusercontent.com/thomasjacquin/allsky/master/html/documentation/troubleshooting/ZWOCameras.html) for notes on the ASI120-series and related T7 / T7C cameras.
> - The Pi Zero with its limited memory and _very_ limited CPU power (single CPU core), is **not** recommended. You will most likely not be able to create keograms, startrails, or timelapse videos.
> - The Pi Zero 2 with its limited memory and somewhat limited CPU power, is not recommended unless cost is the only concern. Creating keograms, startrails, and timelapse videos may or may not be possible.
> - The Le Potato is the only "Pi-compatible" board that we've found to actually be compatible, so buyer beware.
---
## Software Installation
PatriotAstro created a great [video](https://www.youtube.com/watch?v=7TGpGz5SeVI) describing the installation steps below.
**We highly suggest viewing it before installing the software.**
Detailed installation instructions can be found at [Installing / Upgrading --> Allsky](https://htmlpreview.github.io/?https://raw.githubusercontent.com/thomasjacquin/allsky/master/html/documentation/installations/Allsky.html).
---
## Web User Interface (WebUI)
The WebUI is now installed as part of Allsky and is used to administer Allsky, and to a lesser extent, your Pi. It can also be used to view the current image as well as all saved images, keograms, startrails, and timelapse videos.
A public page is also available in order to view the current image without having to log into the WebUI and without being able to do any administrative tasks. This can be useful for people who don't have a Allsky Website but still want to share a view of their sky:
```
http://your_raspberry_IP/public.php
```
Make sure this page is publically viewable.
If it is behind a firewall consult the documentation for your network equipment for information on allowing inbound connections.
---
## Allsky Website
By installling the optional Allsky Website you can display your files on a website on the Pi, on another machine, or on both.
See [Installation / Upgrading --> Website](https://htmlpreview.github.io/?https://raw.githubusercontent.com/thomasjacquin/allsky/master/html/documentation/installations/AllskyWebsite.html) for information on how to install and configure an Allsky Website.
---
## Post-capture processing
Captured images can be resized, cropped, and stretched, and bad images (i.e., too light or too dark) can be removed automatically.
Allsky supports running "modules" after each picture is taken to change the image (e.g., add an overlay) or perform other tasks (e.g., count the number of stars in the image). You can determine what modules to run and in what order. Modules can pass data to other modules, for example, the Start Count Module can pass the star count to the Overlay Module to be added to the overlay.
The Overlay Editor lets you easily specify what text and images you want in your overlay, and place them using drag-and-drop. Each field can be formatted however you want (font, color, size, position, rotation, etc.). The only limit is your imagination!!
See [Explanations / How To -> Overlays](https://htmlpreview.github.io/?https://raw.githubusercontent.com/thomasjacquin/allsky/master/html/documentation/overlays/overlays.html) and [Explanations / How To -> Modules](https://htmlpreview.github.io/?https://raw.githubusercontent.com/thomasjacquin/allsky/master/html/documentation/modules/modules.html) for more information.
---
## Dark frame subtraction
Dark frame subtraction removes hot pixels from images by taking images at different temperatures with a cover on your camera lens and subtracting those images from nighttime images.
See [Explanations / How To -> Dark frames](https://htmlpreview.github.io/?https://raw.githubusercontent.com/thomasjacquin/allsky/master/html/documentation/explanations/darkFrames.html) for more information.
---
## Timelapse and mini timelapse
By default, a timelapse video is generated at the end of nighttime from all of the images captured in the last 24 hours.
"Mini" timelapse videos can also be created every few images, and contain the last several images. They are useful to see what the sky was recently like.
---
## Keograms
A **Keogram** is an image giving a quick view of the day's activity.
For each image a central vertical column 1 pixel wide is extracted. All these columns are then stitched together from left to right. This results in a timeline that reads from dawn to the end of nighttime (the image above only shows nighttime data since daytime images were turned off).
See [Explanations / How To --> Keograms](https://htmlpreview.github.io/?https://raw.githubusercontent.com/thomasjacquin/allsky/master/html/documentation/explanations/keograms.html).
---
## Startrails
**Startrails** are generated by stacking all the images from a night on top of each other.
In the image above, Polaris is centered about one-fourth the way from the top.
See [Explanations / How To --> Startrails](https://htmlpreview.github.io/?https://raw.githubusercontent.com/thomasjacquin/allsky/master/html/documentation/explanations/startrails.html).
---
## Automatic deletion of old data
You can specify how many days worth of images to keep in order to keep the Raspberry Pi SD card from filling up. If you have the Allsky Website installed on your Pi, you can specify how many days worth of its imags to keep.
See the **DAYS_TO_KEEP** and **WEB_DAYS_TO_KEEP** settings in [Settings --> Allsky](https://htmlpreview.github.io/?https://raw.githubusercontent.com/thomasjacquin/allsky/master/html/documentation/settings/allsky.html).
---
## Share your sky
If you want your allsky camera added to the [Allsky map](http://www.thomasjacquin.com/allsky-map), see [Put your camera on Allsky Map](https://htmlpreview.github.io/?https://raw.githubusercontent.com/thomasjacquin/allsky/master/html/documentation/miscellaneous/AllskyMap.html).
If you know anyone in Greenland or Antartica, send them a camera!!
---
## Release changes
See the
[Allsky Version Change Log](https://htmlpreview.github.io/?https://raw.githubusercontent.com/thomasjacquin/allsky/master/html/documentation/changeLog.html)
for a list of changes in this release and all prior releases.
---
## Donation
If you found this project useful, here's a link to send Thomas a cup of coffee :)
[](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=MEBU2KN75G2NG&source=url)