A comprehensive Python script that automates the preprocessing workflow for smart telescopes, including file conversion, registration, stacking, and SPCC color calibration.
Supported Telescopes:
- ZWO Seestar S30
- ZWO Seestar S30 Pro
- ZWO Seestar S50
- Dwarf Mini
- Dwarf 2
- Dwarf 3
- Celestron Origin
- Unistellar eVscope 1 / eQuinox 1
- Unistellar eVscope 2 / eQuinox 2
- Unistellar Odyssey / Odyssey Pro
Features:
- Allow batching into smaller subset of images to save space and faster processing. Max batch count on Windows is 2,000 and on Mac/Linux is 25,000
- Optional calibration frame support (darks, flats, biases)
- Automatic master frame creation from calibration files
- Drizzle integration for improved resolution
- Background extraction and filtering options
- Spectrophotometric Color Calibration (SPCC) for supported telescopes
- Save/Load presets functionality
Demo Video: YouTube - Smart Telescope Processing
- Must have a
lightssubdirectory in your working directory - Calibration frames are optional
- Supports automatic batching for large datasets
- Need local Gaia catlog in order to plate solve and stitch mosaics
- Using compression may make the script run faster and use less space but not guaranteed
SPCC requires local Gaia catalog for best results*
An advanced OSC (One Shot Color) image preprocessing script designed for processing images from multiple sessions with full mosaic and alignment capabilities.
Features:
- Multi-session support with individual file management
- Automatic plate solving and mosaicking for images with proper headers
- Star alignment fallback for images without coordinates
- Session-based organization and processing
- Individual session stacking option in addition to merged stacks
- Master frame creation from single calibration files
- Preprocessed lights collection for later combination
- Experimental mono camera support (no debayering)
- Comprehensive filter settings for image quality control
Demo Video: YouTube - OSC Image Processing
- Can be run from any directory
- Supports multiple sessions with different frame types
- Images are copied/symlinked for processing (requires disk space)
- Individual sessions can be processed separately or combined
- Experimental mono mode bypasses debayering for monochrome cameras
A dedicated monochrome image preprocessing script for narrowband and LRGB imaging. Built for multi-filter, multi-session workflows, and it produces a separate final stack per filter, ready for compositing.
This only works with FIT(S) files with proper headers. Master calibration frames can be either FIT(S) or XISF.
Features:
- Multi-session support with individual file management
- Filter-aware processing: lights and flats are auto-grouped by their FITS
FILTERheader, producing one final stack per filter (HA/SII/OIII, LRGB, etc.) - "Combine Like Filters" to merge sessions that share a filter into one
- Mosaic mode with
Panel Ndetection: same-panel sessions are pooled across nights and stitched into a per-filter mosaic - "Register final frames" to align the per-filter stacks to a common canvas for direct color combination
- Reusable Master Calibration config: set a master darks folder + master bias once and reuse them between runs (saved to
naztronomy_scripts_config.json) - "Import Masters" matches a master dark to each session by exposure time and temperature, and applies the master bias to every session
- Master frame support for both FITS and PixInsight XISF files (matched by file name: masterDark, masterBias, masterFlat)
- Drag & drop of files or whole folders, with automatic frame-type and session detection
- Export Sessions to an AstroBin acquisition CSV (with a Bortle sky-quality prompt)
- Drizzle, background extraction, feathering, and comprehensive filter (roundness/FWHM/star count/background) options
- Save/Load presets functionality
- Can be run from any directory
- Tag sessions by filter (auto-detected from FITS headers) for per-filter stacks
- Master darks are matched by exposure time and temperature; the master bias is applied to all sessions
- XISF support is limited to master calibration frames (read by file name only)
- Images are copied/symlinked for processing (requires disk space)
- Organize mosaics as
Object/Panel N/...for automatic panel detection
Two ways to install these scripts:
- Manual: Place the Python
.pyfiles from this repository in your local Siril scripts directory - Automatic: Install directly through Siril by going to Scripts >> Get Scripts in Siril and searching for "Naztronomy"
- Siril 1.3.6 or later (1.4.1 recommended)
- Python packages: PyQt6, numpy, astropy (automatically installed by the scripts)
- Recommended: Blank working directory for clean setup
- Windows File Limit: The
.ssfscripts do not work with file counts > 2048 on Windows - OSC Optimization: Current scripts are optimized for OSC cameras (mono support is experimental)
- Disk Space: OSC script copies files before processing, requiring additional storage
- Nazmus Nasir - Naztronomy
- YouTube - YouTube.com/Naztronomy
- Patreon - Become a Patron
- Buy Me a Coffee - Become a Supporter
- Discord - Join our Online community
- Bluesky - Bluesky/Naztronomy.com
- Instagram - IG/Naztronomy
If these scripts have been useful to you, consider supporting the project — it helps fund continued development and new features:
- Patreon — patreon.com/c/naztronomy
- Buy Me a Coffee — buymeacoffee.com/naztronomy
- YouTube Memberships — youtube.com/naztronomy/join
- GitHub Sponsors — github.com/sponsors/naztronomy
This project is licensed under the SPDX-License-Identifier: GPL-3.0-or-later- see the LICENSE file for details
Have questions? You can reach out through several channels:
- Create an issue in the issues forum
- Join our Discord community
- Comment on the demo videos on YouTube
- Check the help sections within each script
Pull requests are welcome! Please see CONTRIBUTING.md for full guidelines. Key points:
- All pull requests must target the
developbranch — do not open PRs againstmaindirectly - New features must be non-breaking — all existing functionality must continue to work as expected
- Test your changes thoroughly before submitting
- Follow the existing code style and update documentation as needed
- Bug fixes and new features will be reviewed before merging
A legacy Siril script optimized for broadband (UV/IR block) filters. Automates stacking and mosaic creation for Seestar telescope images.
A legacy Siril script tailored for narrowband (LP) filters, handling stacking and mosaic generation for Seestar telescope images.