SER Viewer 1.0.0

A player for SER video files — the format used in solar, lunar and planetary
astronomy imaging — with the features of
SER Player plus FITS export.
First release, for macOS and Windows.

Downloads

Platform	File
macOS (Apple silicon)	SER-Viewer-1.0.0-macOS-arm64.dmg
macOS (Intel)	SER-Viewer-1.0.0-macOS-x86_64.dmg
Windows (x64)	SER-Viewer-windows.zip

The applications are unsigned. On macOS, right click SER Viewer.app and choose
Open for the first launch (or allow it under System Settings → Privacy &
Security). On Windows, choose More info → Run anyway if SmartScreen appears.

Highlights

Playback — frame stepping, reverse play, looping, in/out markers that limit
both playback and every export, zoom from 5% to 1600% with drag panning, the raw
ADU value under the cursor, and per-frame UTC timestamps read from the SER
trailer.

Processing, applied live — debayer (RGGB / GRBG / GBRG / BGGR, CMYG
approximated), gain, gamma, black level, per-frame auto stretch, saturation, RGB
balance, channel alignment for atmospheric dispersion, monochrome conversion,
invert, flip, rotate, and a crop that snaps to even coordinates so the Bayer
phase survives. Plus a per-channel histogram and a full SER header inspector.

FITS export — the reason this exists alongside SER Player:

• One 3D cube (frames, height, width), or (frames, 3, height, width) for
  colour, with per-frame times in a FRAMETIME binary table extension. The cube
  is streamed to disk, so a multi-gigabyte SER file does not need matching memory.
• Numbered sequence for AutoStakkert!, RegiStax, Siril and PIPP.
• Raw Bayer with BAYERPAT / XBAYROFF / YBAYROFF, debayered RGB
  (CTYPE3 = 'RGB'), or monochrome.
• Native depth, 16 bit unsigned (BZERO = 32768) or 32 bit float.
• DATE-OBS, MJD-OBS, DATE-END, OBSERVER, TELESCOP, INSTRUME,
  OBJECT, EXPTIME, FOCALLEN, XPIXSZ, ROWORDER and SER provenance cards.
• Pixel values are left unchanged by default, so a 12 bit camera keeps its
  0–4095 values and the data stays linear for stacking and photometry.

Other exports — PNG / TIFF (8 and 16 bit), BMP, JPEG, lossless AVI
(uncompressed RGB or FFV1), Motion JPEG and MPEG-4 AVI, H.264 MP4, animated GIF,
and trimmed or cropped SER files that keep the original pixel values.

Format handling

SER files in the wild are not always well formed, so SER Viewer handles the
inverted LittleEndian flag (1 means big endian), trailers written in local
time instead of UTC, recorders that misreport PixelDepthPerPlane (the real
depth is measured from the data), and truncated files.

Verification

49 tests run on Ubuntu, macOS and Windows. Every binary attached here was built
by CI and then had to pass --selftest — writing a SER file, reading it back,
debayering, exporting FITS and PNG, and starting the Qt interface — before it
was published.

Credits

Application developed by Kiyoaki Okudaira — Kyushu University Hanada Lab (Space
Systems Dynamics). Supported by JSPS KAKENHI Grant Number JP26H02172.

Inspired by SER Player by Chris Garry (GPL-3.0); no code was taken from it.
MIT licensed. See the README
for full documentation.

---

日本語

天文（太陽・月・惑星）撮像で使われる SER 動画ファイルのプレイヤーです。
SER Player の機能に加えて FITS 書き出し
を備えています。macOS と Windows 対応の最初のリリースです。

ダウンロード

環境	ファイル
macOS（Apple Silicon）	SER-Viewer-1.0.0-macOS-arm64.dmg
macOS（Intel）	SER-Viewer-1.0.0-macOS-x86_64.dmg
Windows（x64）	SER-Viewer-windows.zip

署名なしのため、macOS では初回のみ SER Viewer.app を右クリックして「開く」を
選んでください（システム設定 → プライバシーとセキュリティからでも可）。
Windows で SmartScreen が出た場合は「詳細情報 → 実行」を選びます。

主な機能

再生 — コマ送り・逆再生・ループ、開始／終了マーカー（再生にも書き出しにも適用）、
5%〜1600% のズームとドラッグでのパン、カーソル位置の生の ADU 値表示、
SER 末尾のタイムスタンプによるフレーム毎の UTC 時刻表示。

画像処理（表示にリアルタイム反映） — デベイヤー（RGGB / GRBG / GBRG / BGGR、
CMYG 系は近似）、ゲイン、ガンマ、黒レベル、フレーム毎オートストレッチ、彩度、
RGB バランス、大気分散補正用のチャンネルアライン、モノクロ変換、階調反転、反転、
回転、ベイヤー位相を保つ偶数スナップのクロップ。チャンネル別ヒストグラムと
SER ヘッダ詳細表示も備えます。

FITS 書き出し — SER Player に対する本ソフトの主眼です：

• 3D キューブ 1 ファイル (フレーム数, 高さ, 幅)（カラーは 4 次元）。
  フレーム毎の時刻は FRAMETIME バイナリテーブル拡張に格納。ディスクへ
  ストリーミング書き込みするため、数 GB の SER でもメモリを圧迫しません。
• 連番ファイル — AutoStakkert! / RegiStax / Siril / PIPP 向け。
• 生ベイヤー（BAYERPAT 付き）／デベイヤー後 RGB／モノクロ。
• 元のビット深度／16 bit 符号なし（BZERO = 32768）／32 bit 浮動小数点。
• DATE-OBS、MJD-OBS、OBSERVER、TELESCOP、INSTRUME、OBJECT、
  EXPTIME、FOCALLEN、XPIXSZ、ROWORDER などを自動記入。
• 既定では画素値を一切加工しません。 12 bit カメラなら 0〜4095 の値が
  そのまま残り、スタックや測光にリニアなまま使えます。

その他の書き出し — PNG / TIFF（8・16 bit）、BMP、JPEG、可逆 AVI（無圧縮 RGB /
FFV1）、Motion JPEG・MPEG-4 AVI、H.264 MP4、アニメーション GIF、
トリミング／クロップした SER ファイル（画素値は無劣化）。

フォーマット対応

実在する SER ファイルは仕様どおりでないことがあるため、LittleEndian = 1 が
ビッグエンディアンを意味する仕様のクセ、UTC でなく現地時刻で書かれた
タイムスタンプ、PixelDepthPerPlane の誤記（実データから実効深度を測定）、
途中で切れたファイルに対応しています。

検証

Ubuntu / macOS / Windows で 49 件のテストを実行しています。ここに添付された
バイナリはすべて CI がビルドし、--selftest（SER 書き出し→読み戻し→デベイヤー→
FITS・PNG 書き出し→GUI 起動）に合格したもののみを公開しています。

開発・謝辞

Application developed by Kiyoaki Okudaira — Kyushu University Hanada Lab
(Space Systems Dynamics)。Supported by JSPS KAKENHI Grant Number JP26H02172.

SER Player（Chris Garry 作、GPL-3.0）に着想を得ていますが、コードは流用していません。
MIT ライセンス。詳細は README を参照してください。