Hoshiko Viewer

ハワイのマウナケアの星空をほぼリアルタイムでスタックし、表示します。

同時に、タイムラプス動画を作成します。

スタックは、比較明合成、減光比較明合成、シンプルの３つのモードがあります。

入力は、YouTube, RTSP, USB Camera, mp4ファイルに対応しています。

Windows版 hoshiko_viewer ダウンロード

V1.12.0 hoshiko_viewer.zip お試し版

1つ前のバージョン V1.11.0 hoshiko_viewer.zip

1つ前のバージョン V1.10.1 hoshiko_viewer.zip

Windows 版インストール方法

重要：実行方法

OpenH264 libraryのインストール

Windows版実行方法

解像度

Mac版 hoshiko_viewer ダウンロード

Under Construction

hoshiko_viewer 使用方法

        hoshiko_viewer.exe [--resolution RESOLUTION] [--input URL] [--output FILE] [--speed SPEED] [--seconds SECONDS] [--duration DURATION] [--no_display] [--write_image] [--fast] [--mode [reduce|mlc|simple]]
        
        引数:
            --resolution RES, -r RES
                YouTube動画の解像度を指定します（デフォルト: 1920x1080）。
                例: --resolution 1920x1080
                    -r 2560x1440
                    
            --input URL, -i URL
                ビデオの入力ソースを指定します:
                    YouTubeライブ動画の例:
                    --input https://www.youtube.com/watch?v=7dyUXAje43g
        
                    AtomCam2などのRTSPプロトコルの例:
                    --input rtsp://6199:4003@192.168.0.15/live
        
                    USBカメラの例:
                    --input usb:0
        
            --output FILE, -o FILE
                タイムラプス動画の出力ファイルパスを指定します。
                --output none の場合は、タイムラプスを生成しません。
        
            --speed SPEED, -s SPEED
                タイムラプス動画の再生速度（N倍速）を指定します（デフォルト: 30）。
        
            --seconds SECONDS
                スタッキングする秒数を指定します（デフォルト: 30秒）。
                比較明合成（スタッキング）に使用するフレームの数を指定します。
        
            --duration DURATION
                スクリプトの実行時間を指定します（例: 12:00は12時間を意味します）。
                指定した時間が経過したら実行を終了します。
        
            --no_display, -n
                mp4ファイルの場合、動画を表示しません。
        
            --write_image, -w
                SPEED / 30 秒ごとに、比較明合成結果をJPGファイルとして出力します。
                --output に指定した mp4ファイルと同じ場所に、JPGファイルを出力します。
        
            --mode, -m [reduce|simple|mlc]
                スタックモードを選択: 指定しない場合は、reduce (減光比較明合成)です。
                    reduce  減光比較明合成
                    mlc     比較明合成
                    simple  スタック合成。--speed >= 1。
                    simple_fast  スタック合成（高速）。ただし、--speed >= 30。
                
            --fast, -f
                高速処理。デフォルトはオフで、30fps で処理します。
                --fastを指定すると、画像がカクカクする場合があります。

            --cookies, -c
                yt-dlp に渡す --cookies-from-browser オプションを指定します。
                例  --cookies chrome
                    --cookies edge

            --version, -v
                バージョン情報を表示します。
        
        例:
            デフォルト値を使用する場合:
                hoshiko_viewer.exe
            
            引数を指定する場合:
                hoshiko_viewer.exe --input https://www.youtube.com/watch?v=7dyUXAje43g --output output.mp4 --speed 60 --seconds 60 --duration 12:00
    

スタックモードについて

次の３つの画像は、それぞれ同じ時間で処理したものです。

--mode reduce または --mode を指定しない場合、減光比較明合成します。過去のフレームを徐々に減光します。

--mode mlc 比較明合成 流星や衛星の経路を確認しやすくなります。

--mode simple スタック合成 きれいな画像が生成できますが、流星や衛星は見えにくくなります。

hoshiko_editor 使用方法

hoshiko_editor.exe [--input FILE] [--output FILE] [--resize FACTOR] [--crop X Y W H] [--speed SPEED] [--convert ALPHA BETA]

Windows版 hoshiko_editor

hoshiko_editorは、こちらを参照してください。

引数

• --input FILE: 入力動画ファイルのパスを指定します（デフォルト: test.mp4）。
• --output FILE: 出力動画ファイルのパスを指定します（デフォルト: output.mp4）。
• --resize FACTOR: リサイズ倍率を指定します（デフォルト: 1.0）。
• --crop X Y W H: クロップパラメータを指定します（X Y W H）。指定しない場合はクロップを行いません。
• --speed SPEED: 速度倍率を指定します（1以上の整数、デフォルト: 1）。
• --convert ALPHA BETA: コントラストと明るさの調整パラメータを指定します（デフォルト: 1.0 0.0）。
• -h, --help: ヘルプメッセージを表示して終了します。

例

hoshiko_editor.exe --input input.mp4 --output output.mp4 --resize 0.75 --crop 100 100 800 600 --speed 2 --convert 1.2 10

この例では、input.mp4を読み込み、0.75倍にリサイズし、(100,100)から幅800、高さ600のサイズでクロップします。 さらに、再生速度を2倍にし、コントラストを1.2倍、明るさを10増加させます。結果はoutput.mp4として保存されます。

注意事項

• 速度倍率（--speed）は1以上の整数である必要があります。
• クロップパラメータを指定する場合、元の動画サイズを超えないようにしてください。
• リサイズ倍率は0より大きい値を指定してください。

バージョン情報

2026/1/18 V1.12.0 YouTube仕様変更対応。yt-dlp 2025.12.08 をご使用ください。

2025/12/17 V1.11.0 yt-dlp --resolution オプション追加。

2025/4/30 V1.10.1 yt-dlp --cookies-from-browser オプション対応。修正版。

2025/3/7 V1.9.0 YouTube の仕様変更対応。yt-dlp --update を実行して、最新版を入手してください。

2025/1/22 V1.8.0 YouTube の仕様変更対応。yt-dlp 2025.1.15が必要です。yt-dlp --update を実行して、最新版を入手してください。

2024/9/11 V1.7.0 --mode simple で、--speed を等倍速以上をサポート。simple_fast モードを追加。webmファイルをサポート。

2024/9/11 V1.6.1 AVIファイル対応。

2024/9/8 V1.6 MP4ファイルの場合、最大4K解像度まで対応。

2024/7/30 V1.5.2 --output none を指定した場合、タイムラプスを生成しないように修正

2024/7/29 V1.5.1 フリーズするバグを修正

2024/7/27 V1.5 FPS表示、FPS自動調整、高速化

2024/7/23 V1.4 --fast を追加。--mode を追加

2024/7/18 V1.3 --duration を追加。停止までの時間を指定可能。

2024/7/16 V1.2 比較明合成の静止画出力対応

2024/7/5 V1.1 比較明合成のタイムラプス生成

2024/6/9 V1.0 初期バージョン