This repository provides a Debian Live environment to easily run edge devices for the on-campus DJ event "The Utopia Tone". It includes utone-ndi-utils and an automatic signage system.
このリポジトリは、学内DJイベント "The Utopia Tone" のエッジデバイスを容易に動作させるためのDebian Live環境を提供します。utone-ndi-utilsや、自動サイネージシステムを含みます。
Download the image from Releases and write it to a DVD or USB drive. To write to a USB drive, use a tool like Rufus.
If you want to keep settings after reboot, specify the size of the persistent storage in Rufus settings. 1GB is sufficient for most cases. If you plan to use NDI transmission or signage, setting up persistent storage is recommended.
Releasesからイメージをダウンロードし、DVDまたはUSBメモリに書き込みます。USBメモリに書き込む場合は、Rufus等のツールを使用します。
再起動しても設定が保持されるようにするには、Rufusの設定で保存領域のサイズを指定します。1GB程度で十分です。NDI送信やサイネージの設定を行う場合には、保存領域の設定を推奨します。
Insert the completed DVD or USB drive into your PC and power it on to boot into the Live environment.
完成したDVDまたはUSBメモリをPCに挿入し、電源を投入するとLive環境が起動します。
To receive NDI signals, run the following command:
NDI信号を受信するには、以下のコマンドを実行します:
nrxTo change the connection destination, edit the .config/systemd/user/ndi-rx.service in your home directory and enable the service:
接続先を設定して自動起動を有効にするには、ホームディレクトリの .config/systemd/user/ndi-rx.service を編集します:
vim ~/.config/systemd/user/ndi-rx.service
systemctl --user enable --now ndi-rx.serviceTo transmit NDI signals from a capture board, run the following command:
キャプチャーボードからNDI信号を送信するには、以下のコマンドを実行します:
ntxTransmits NDI signals as <HOSTNAME> (TX).
NDI信号を <HOSTNAME> (TX) として送信します。
If you want to change arguments such as the transmission name, resolution, or frame rate, edit .config/systemd/user/ndi-tx.service in the home directory and enable the service. List of arguments can be checked with uv run /opt/utone-ndi-utils/tx.py --help.
送信名や解像度、フレームレートなどの引数を変更し自動起動を有効にする場合は、ホームディレクトリの .config/systemd/user/ndi-tx.service を編集し、サービスを起動します。引数の一覧は、uv run /opt/utone-ndi-utils/tx.py --helpで確認できます。
vim ~/.config/systemd/user/ndi-tx.service
systemctl --user enable --now ndi-tx.serviceThe default hostname is debian. To change the hostname, use the command sudo hostnamectl set-hostname <new hostname>.
初期設定のホスト名は debian です。ホスト名を変更するには、sudo hostnamectl set-hostname <新しいホスト名> と入力します。
After booting, you will need to configure Wi-Fi and enter NAS credentials.
起動後、Wi-Fiの設定とNASの資格情報の入力が必要です。
sudo nmtui
vim .smbcredentialsTo change the NAS IP address, edit kiosk-start.sh in your home directory:
NASのIPアドレスを変更するには、ホームディレクトリの kiosk-start.sh を編集します。
vim kiosk-start.shTo start the signage, run the kiosk-start.sh script in your home directory:
サイネージを起動するには、ホームディレクトリの kiosk-start.sh を実行します。
./kiosk-start.shTo enable automatic startup, add the following line to your .bashrc file:
自動起動を設定するには、.bashrc に以下の行を追加します。
exec ~/kiosk-start.shTo append this line in one command, you can run:
ワンライナーで追記するには、以下のコマンドを実行します。
echo "exec ~/kiosk-start.sh" >> ~/.bashrcTo build the ISO image, you need a Debian environment. If you are using Windows, you can easily set up a Debian environment using WSL2.
ビルドにはDebian環境が必要です。Windowsを使用している場合は、WSL2を利用することで簡単にDebian環境を構築できます。
wsl --update
wsl --list --online
wsl --install -d DebianInstall live-build in a Debian environment:
Debian環境でlive-buildをインストールします。
sudo apt install live-buildTo build the ISO image, you need to clone this repository and edit the files in work/config. Make sure to clone with the --recursive option.
このリポジトリをクローンし、work/config内を編集します。--recursiveオプションを付けてクローンしてください。
git clone https://github.com/TechnoTUT/utone-linux.git --recursive
cd utone-linux/workBuild the ISO image with the following command:
isoイメージをビルドします。
lb config --distribution 'trixie' --archive-areas 'main non-free non-free-firmware contrib' --bootappend-live 'boot=live components splash persistence' --image-name 'technotut-utone-live'
sudo lb buildSuccessful execution will create a directory named technotut-utone-live-amd64.hybrid.iso in the work directory.
Retry the build with sudo lb clean.
ビルドが完了すると、technotut-utone-live-amd64.hybrid.isoが生成されます。
ビルドをやり直す場合は、sudo lb cleanを実行します。