BlinkGTK インストールガイド

作成者: BlinkGTK Project

各パッケージは Releases からダウンロードしてください。内容物は manifests/ を参照。

注: パス中の 0.1(blinkgtk-0.1 等)は API バージョンです(GTK4 の gtk-4.0 と同じ規約)。製品バージョン(v1.2.0-build2 等)とは独立で、互換性のない API 変更時にのみ変わります。

0. システム要件

項目	要件
アーキテクチャ	x86_64 (amd64)
glibc	2.43 以上(Fedora 44 / Ubuntu 25.10 相当以降)
ディスプレイ	Wayland セッション必須(X11 のみの環境では動作しません)
GTK	GTK4(4.6 以上、4.22 で検証)
GPU	不要(既定は software レンダリング。EGL モードは実験的)

1. RPM(Fedora 44 / x86_64)

依存パッケージは dnf が自動解決します。

# runtime(実行に必須)
sudo dnf install ./blinkgtk-bin-1.2.0-build2.fc44.x86_64.rpm

# アプリを開発する場合(ヘッダ + pkg-config)
sudo dnf install ./blinkgtk-bin-devel-1.2.0-build2.fc44.x86_64.rpm

# Python (PyGObject) / GJS から使う場合
sudo dnf install ./blinkgtk-bin-gir-1.2.0-build2.fc44.x86_64.rpm

# マニュアル(日英)
sudo dnf install ./blinkgtk-bin-doc-1.2.0-build2.fc44.noarch.rpm

RPM は GPG 署名済みです。署名検証を行う場合は公開鍵をインポートしてください。

2. DEB(Debian / Ubuntu / amd64)

依存パッケージは apt が自動解決します(glibc 2.43 以上のリリースが必要です)。

sudo apt install ./libblinkgtk-0.1-0_1.2.0-build2_amd64.deb      # runtime
sudo apt install ./libblinkgtk-0.1-dev_1.2.0-build2_amd64.deb    # 開発用

3. tarball(その他の Linux / glibc / x86_64)

.tar.gz と .tar.bz2 は同一内容です。tarball はパッケージマネージャを通らないため、依存ライブラリを自分で揃える必要があります。

3-1. 依存パッケージの導入(先に実行)

BlinkGTK は Chromium ランタイムを同梱しますが、システム側のライブラリ(GTK4・NSS・音声・印刷・メディア等)に依存します。主要ディストリビューションでは次の 1 コマンドでトップレベル依存が揃います(残りは連鎖導入されます):

Fedora(44 以降):

sudo dnf install gtk4 nss alsa-lib cups-libs dbus-libs at-spi2-core at-spi2-atk \
  libdrm mesa-libgbm mesa-libEGL libxkbcommon wayland-utils libseccomp \
  gstreamer1 gstreamer1-plugins-base openssl-libs sqlite-libs libcurl

Debian / Ubuntu(glibc 2.43 以上のリリース):

sudo apt install libgtk-4-1 libnss3 libasound2t64 libcups2t64 libdbus-1-3 \
  libatk-bridge2.0-0t64 libatspi2.0-0t64 libdrm2 libgbm1 libegl1 \
  libxkbcommon0 libseccomp2 libgstreamer1.0-0 gstreamer1.0-plugins-base \
  libssl3t64 libsqlite3-0

(パッケージ名はリリースにより多少異なります。t64 接尾辞は Ubuntu 24.04 以降の表記です)

アップグレード時 / When upgrading: 旧 tarball を非ルート prefix (例 ~/blinkgtk) に展開していた場合は旧版ディレクトリを削除してから展開してください。RPM/DEB は自動置換されます。 / If you extracted a previous tarball to a non-root prefix, remove the old directory first. RPM/DEB replace automatically.

3-2. 展開

FHS 構成(usr/, etc/)なのでルートに展開します:

sudo tar -C / -xzf blinkgtk-1.2.0-build2-linux-x86_64.tar.gz
sudo ldconfig

システムを汚したくない場合は任意の prefix に展開し、実行時に LD_LIBRARY_PATH を通してください:

mkdir -p ~/blinkgtk && tar -C ~/blinkgtk -xzf blinkgtk-1.2.0-build2-linux-x86_64.tar.gz
export LD_LIBRARY_PATH=~/blinkgtk/usr/lib64/blinkgtk-0.1:~/blinkgtk/usr/lib64/blinkgtk-0.1/chromium

3-3. 依存の不足を機械的に確認(推奨)

ディストリビューションごとのパッケージ名差異に依らず、実際に何が足りないかを次のコマンドで確認できます。出力が空なら依存は揃っています:

PREFIX=/            # ~/blinkgtk に展開した場合はそのパス
ldd $PREFIX/usr/lib64/blinkgtk-0.1/chromium/libcontent.so \
    $PREFIX/usr/lib64/blinkgtk-0.1/libblinkgtk-0.1.so.0.0.0 2>/dev/null \
  | grep "not found" | sort -u

not found が出た場合は、そのライブラリ名でディストリビューションのパッケージを検索して導入してください(例: Fedora dnf provides '*/libasound.so.2' / Debian apt-file search libasound.so.2)。

4. 検証

sha256sum -c SHA256SUMS --ignore-missing

5. 動作確認

ldconfig -p | grep blinkgtk                  # ライブラリ登録確認 (ルート展開時)
pkg-config --modversion blinkgtk-0.1         # devel 導入時

6. アップデート

同じ形式でインストールしたものを上書きします。先に古い版を削除する必要は
ありません(パッケージマネージャが置き換えます)。

# RPM (Fedora)
sudo dnf upgrade ./blinkgtk-bin-1.2.0-build2.fc44.x86_64.rpm \
                 ./blinkgtk-bin-devel-1.2.0-build2.fc44.x86_64.rpm \
                 ./blinkgtk-bin-gir-1.2.0-build2.fc44.x86_64.rpm

# DEB (Debian / Ubuntu)
sudo dpkg -i ./libblinkgtk-0.1-0_1.2.0-build2_amd64.deb \
             ./libblinkgtk-0.1-dev_1.2.0-build2_amd64.deb

tarball の場合は、展開先を一度削除してから展開し直してください。上書き展開
すると、旧版にあって新版に無いファイルが残り、混在した状態になります。

sudo rm -rf /opt/blinkgtk
sudo mkdir -p /opt/blinkgtk
sudo tar xzf blinkgtk-1.2.0-build2-linux-x86_64.tar.gz -C /opt/blinkgtk

アップデート後の確認

pkg-config --modversion blinkgtk-0.1   # 新しい版数が返るか

アプリを再ビルドする必要は通常ありません(SONAME libblinkgtk-0.1.so.0 は
維持されます)。SONAME が変わる変更を行う場合は、リリースノートに明記します。

7. アンインストール

# RPM (Fedora)
sudo dnf remove blinkgtk-bin blinkgtk-bin-devel blinkgtk-bin-gir blinkgtk-bin-doc

# DEB (Debian / Ubuntu)
sudo apt remove libblinkgtk-0.1-0 libblinkgtk-0.1-dev
# 設定ごと消す場合は apt purge

tarball の場合は展開先を削除します。ルートに展開した場合は、同梱されていた
ファイルのみを削除してください。

# 任意の場所に展開した場合
sudo rm -rf /opt/blinkgtk

# ルート (/) に展開した場合 (配布物が置くもののみ)
sudo rm -rf /usr/lib64/blinkgtk-0.1 \
            /usr/include/blinkgtk-0.1 \
            /usr/share/doc/blinkgtk-0.1 \
            /usr/libexec/blinkgtk-0.1
sudo rm -f  /usr/lib64/libblinkgtk-0.1.so.0 \
            /usr/lib64/libblinkgtk-0.1.so \
            /usr/lib64/pkgconfig/blinkgtk-0.1.pc \
            /usr/lib64/girepository-1.0/BlinkGTK-0.1.typelib \
            /usr/share/gir-1.0/BlinkGTK-0.1.gir \
            /usr/share/vala/vapi/BlinkGTK-0.1.vapi \
            /etc/ld.so.conf.d/blinkgtk-0.1.conf
sudo ldconfig

残るもの

BlinkGTK は Chromium と同様に、利用者のホームにプロファイルを作ります。
パッケージを削除しても残るため、不要なら手動で削除してください。

rm -rf ~/.blink_gtk

確認

pkg-config --modversion blinkgtk-0.1   # 何も返らなければ削除済み
ldconfig -p | grep blinkgtk            # 出力が無ければ削除済み

8. トラブルシューティング

症状	原因と対処
`error while loading shared libraries: ...: cannot open shared object file`	依存不足。§3-3 の確認コマンドで特定し、該当パッケージを導入
`GLIBC_2.43 not found`	glibc が古いディストリビューションです。§0 の要件を満たすリリースをご利用ください
起動直後に sandbox 関連のエラーで落ちる(コンテナ等)	環境が Chromium sandbox に対応していません。`BLINKGTK_NO_SANDBOX=1` を設定して起動
ウィンドウが出ない / `Failed to connect to Wayland display`	Wayland セッションで実行してください(X11 セッションは非対応)。`echo $WAYLAND_DISPLAY` で確認
音が出ない / 動画が再生されない	GStreamer プラグイン不足。`gstreamer1-plugins-good`(Fedora)/ `gstreamer1.0-plugins-good`(Debian)を追加

アプリのビルド方法・API は runtime 同梱のドキュメント(/usr/share/doc/blinkgtk-0.1/ — 名称は API バージョン)を参照してください。