Vialとは？使い方・VIAとの違い・Web版とファーム書き込み手順【v0.7.5対応】

Vialは、QMKで動く自作キーボード・メカニカルキーボードのキー配列やマクロを、パソコンの画面から書き換えるための無料のオープンソースソフトです。キー割り当ての変更はその場でキーボードに保存され（マクロ・タップダンス・コンボはSaveを押した時点で保存）、ファームウェアを作り直す必要はありません。なお英単語の vial は薬剤を入れる小瓶（バイアル）の意味で、この記事で扱うのはキーボード用のソフトです。

以下は2026年10月時点の最新版v0.7.5を前提に、公式ドキュメントとソースコードで確かめた内容です。

まとめ：Vialの要点

• 正体：QMKのフォーク「vial-qmk」（ファームウェア）と設定アプリ「vial-gui」の組み合わせ。ライセンスはGPL-2.0で、ソフトは無料です。
• 使い方：Vial対応ファームのキーボードをUSBでつなぎ、画面上段のキーを選んで下段から割り当てを選ぶだけ。キー割り当ては即座に、マクロなどはSaveでキーボードへ保存されます。
• 長押しの調整：タップで文字・長押しで修飾キーにするMod-TapはQuantumタブで割り当て、誤爆はQMK SettingsのTap-Holdで直します。
• Web版：vial.rocks を対応するChrome・Chromium・Edgeで開けば、インストールなしでキーマップやマクロを編集できます。ただし、マクロの直接記録など、デスクトップ版に限定された機能があります。
• VIAとの違い：Vialはキーボードの定義をファームに内蔵するので、中央リポジトリへの登録を待たずに使えます。タップダンス・コンボ・キーオーバーライドもGUIで設定できます。
• 注意点：VIA用ファームのままでは動かないか機能が限られます。Vial対応ファームへの書き換えが前提です。

Vialの正体：vial-qmkとvial-guiの2層構成

Vialは1本のソフトではなく、キーボード側とパソコン側の2つで成り立っています。公式サイト（get.vial.today）の説明は「Windows・Linux・Mac対応のGUIと、キーボードをリアルタイムに設定するためのQMKフォーク」です。

アプリの最新版はv0.7.5（2025年8月2日公開）で、ダウンロードページでは今も「beta」と表示されています。直前のv0.7.4（2025年7月12日）でCaps Word・Layer Lock・PDF(layer)などのキーコードと、QMK設定のFlow Tap・Chordal Holdが加わり、v0.7.5ではColemak DH配列の表示が追加されました。2026年10月12日時点でv0.7.5より新しいリリースは出ていません。vial-guiのmainブランチには2026年5月25日までの修正（Dvorak配列のシフト文字表示、LAG・LAG_Tキーの追加など）が入っていますが、配布されているアプリにはまだ含まれていません。

VIA・ZMK Studioとの違い

VIAとの違い：定義JSONの置き場所とGUIで触れる機能

VialとVIAの主な違いは、キーボード定義の持たせ方と、GUIから設定できる機能の範囲です。VIAは、キーボードのソースがQMK本家にマージされ、keymaps/viaがVIA側のユーザースペースにマージされ、定義JSONがVIAのリポジトリにマージされる、という3条件を満たすことで公式対応として自動認識されます。Vialは vial.json をファームに埋め込むため、キーボードをつなげばアプリが配置を読み取ります。

VIAのWebアプリもGPL-3.0で公開されているので、オープンソースかどうかは両者の違いになりません。VIAの公式説明が挙げる機能はキーマップ・マクロ・RGB設定で、Vialはそこにタップダンス、コンボ、キーオーバーライド、Alt Repeat Key、QMK Settings、マトリクステスターのタブが加わります。VIA用の定義JSONは vial.json の作成元として利用できますが、公式の移植ガイドは内容の確認・編集と、Vialアプリの「Load dummy JSON」による表示確認を案内しています（QMKの info.json は流用できません）。

ZMK Studioとの違い：無線対応と設定可能な機能

分割型の無線キーボードでよく使われるZMKにも、再書き込みなしでキーマップを変える「ZMK Studio」があります。ZMKはZephyr RTOS上のMITライセンスのファームで、無線を前提に設計されています。ZMK StudioはUSBとBluetooth（BLE接続はLinuxのWeb版とネイティブアプリのみ）で編集できますが、公式の機能表ではタップダンス・マクロ・コンボの設定は「Planned（予定）」のままです。

有線のQMK系キーボードでタップダンスやコンボまでGUIで詰めたいならVial、nRF52840などで無線キーボードを組むならZMKが候補です。Vialで編集したい場合は、Rust製のファームRMKも選択肢になります。READMEには、Vialでのキーマップ編集とBLE接続のままの無線編集に対応すると書かれています。ZMKのキーボードではVialは使えません。

Vialの使い方：アプリ版とWeb版の始め方

アプリ版のダウンロードと起動（Windows・macOS・Linux）

公式のダウンロードページに、Windowsのインストーラーとポータブル版、macOSのdmg、LinuxのAppImageが並んでいます。WindowsとmacOSは実行するだけです。LinuxではAppImageに実行権限を付けてから起動します。

chmod +x ~/Downloads/Vial*.AppImage
~/Downloads/Vial*.AppImage

起動後にVial対応キーボードをつなぐと自動で検出され、上部に Keymap・Layout・Macros・Lighting・Tap Dance・Combos・QMK Settings・Matrix tester などのタブが並びます。タブはキーボードのファームが対応している機能の分だけ表示されます。Layoutタブは、分割Backspaceのような配列の選択肢を vial.json に持つキーボードで、どの配列を使うかを切り替える画面です。

Web版vial.rocksの対応ブラウザ

Web版のvial.rocksは、ブラウザからUSB機器と通信するWebHIDを使います。ページには最新のChrome・Chromium・Edgeを推奨すると書かれており、WebHIDに対応していないブラウザでは「Start Vial」を押してもエラーになります。アプリを入れられないPCや、一度だけ設定を変えたい場合はWeb版で足ります。

Linuxで認識されないときのudevルール

LinuxではキーボードのHIDデバイスに一般ユーザーが書き込めず、Vialが検出しないことがあります。公式マニュアルは、Vialファームだけに一致するudevルールを /etc/udev/rules.d/59-vial.rules に書く方法を案内しています。

KERNEL=="hidraw*", SUBSYSTEM=="hidraw", ATTRS{serial}=="*vial:f64c2b3c*", MODE="0660", GROUP="users", TAG+="uaccess", TAG+="udev-acl"

sudo udevadm control --reload
sudo udevadm trigger

以前のマニュアルはファイル名を 99-vial.rules としていましたが、systemd側の変更（systemd issue #39056）に合わせて 59-vial.rules に改められました。以前の手順で設定して最近認識されなくなった場合は、ファイル名の番号を変えてください。

日本語配列（JIS）への表示切り替え

初期状態のキーの表示はUS配列です。メニューの「Keyboard layout」から「Japanese (QWERTY)」を選ぶと、記号キーの表示がJIS配列の刻印に合わせて変わります。変換・無変換・円記号も、それぞれ KC_HENK・KC_MHEN・KC_JYEN として割り当てられます。

キーマップの編集とレイヤー切り替えキー

キーの割り当てと.vilファイルへのバックアップ

編集は、上段のキーボード図で変えたいキーをクリックし、下段のパレットから割り当てるキーを選ぶだけです。変更はすぐキーボードに書き込まれ、保存ボタンはありません。設定一式は File メニューの「Save current layout…」で .vil ファイルに書き出せます。ファームを書き直す前や別のPCへ移る前に保存しておくと、「Load saved layout…」で元に戻せます。

レイヤー切り替えキー（MO・TG・LT・Layer Lock）

レイヤーは既定で4枚まで使えます（ファームの設定で最大32枚）。上部の番号でレイヤーを切り替えて編集し、下段パレットの Layers タブから切り替えキーを割り当てます。

レイヤーは重ねた状態で複数同時に有効になり、番号の大きいレイヤーが優先されます。下のレイヤーへ戻るキーはMOではなくTOで作るのが原則です。▽の表示は「透過」で、下のレイヤーの割り当てがそのまま使われます。LM(レイヤー, 修飾キー) のようにパレットにないキーコードは「Any key」機能で直接入力できます。

修飾キー付きキーとMod-Tap：Quantumタブの割り当て

Ctrl＋Cのようなショートカットを1キーで出す、タップでは文字・長押しではShiftにする、といった割り当ては下段の Quantum タブにあります。公式マニュアルのQuantumの章によると、どちらも2段階で割り当てます。まずQuantumタブから外側のキーを置き、キーの中に出る小さな枠を選んで、Basicタブから中身のキーを選びます。

中身のkcに選べるのはBasicタブのキーだけで、これはQMK側の制約です。LGuiはWindowsキー（macOSではCommand）、LAltはmacOSのOptionにあたります。GUIに無い組み合わせは、Any keyに MT(MOD_RSFT | MOD_RALT, KC_A) のようにQMKの書式で入力します。

マクロ・タップダンス・コンボ・キーオーバーライドの設定

マクロ：既定16個、記録機能は下書き用

Macros タブで M0〜M15 の16個（既定値）を編集できます。右下の「Add action」でキーの押下・タップ・解放・待ち時間を並べるか、Windows・Linuxのデスクトップ版では「Record macro」でキーボードから直接記録します。macOS版とWeb版では記録機能を使えないため、Add actionで入力します。公式マニュアル自身が記録は「あまり信頼できない」と書いているので、記録したものを Add action で整える使い方が確実です。編集後は Save を押すまで反映されません。作ったマクロは、キーマップ画面で下段の Macro タブから割り当てます。

タップダンス：1キーへの4動作の割り当て

Tap Dance タブの各スロットに、On tap（タップ）、On hold（長押し）、On double tap（2回タップ）、On tap + hold（タップ後に長押し）の4動作と、タップと長押しを分ける時間 Tapping term を設定します。たとえばタップでWindowsキー、長押しでレイヤー1という割り当てができます。設定後にSaveを押し、Keymap画面で対象の物理キーを選んで、下段のTap Danceから設定したスロットを割り当てます。スロット数はマイコンのEEPROM容量から自動で決まります。

コンボ（同時押し）：最大4キーで1つの動作

Combos タブでは、最大4つのキーの組み合わせに1つの出力を割り当てます。コンボ判定時間（combo term）内に全キーが押されると発動し、キーマップのどこかに割り当てる必要はありません。「A＋SでEsc」「＝とBackspaceでDelete」が定番の例です。判定時間は QMK Settings の Combo 項目で変えます。Combosタブの編集後はSaveを押して設定を保存します。

キーオーバーライドとAlt Repeat Keyの動作例

Key Overrides は「修飾キー＋キー」の組み合わせを別の組み合わせに置き換える機能で、Shift＋1で「!」以外を出す、といった変更ができます。Alt Repeat Key は直前のキーの「逆の動作」を出すキーで、Ctrl＋Shift＋→（次の単語を選択）の後に Ctrl＋Shift＋← を出すような定義ができます。Alt Repeat Keyの設定画面はv0.7.4で加わりました。

QMK SettingsのTap-Hold設定とホームロウモッド

QMK Settings タブでは、Tap-Hold、Auto Shift、コンボ、ワンショットキー、マウスキー、Grave Escape、Magicキーの細かい値を変えられます。「長押しのつもりがタップになる」「速く打つと修飾キーが誤爆する」といった症状は、キーマップより先にTap-Holdの値を疑ってください。Tap-Holdの設定は、Mod-Tapキーとレイヤー用のLTキーの両方に効きます。

Tapping Termの初期値は、ファームのソース（quantum/action_tapping.h）で200msです。A・S・D・FやJ・K・L・;に修飾キーを重ねる「ホームロウモッド」では、公式マニュアルが次の設定を出発点にするよう勧めています。

• ホームロウのキーには LCtl_T(kc) などのMod-Tapを使い、タップダンスでは作らない
• Permissive HoldとChordal Holdにチェックを入れ、Hold On Other Key Pressは外す
• Tapping Termは250msから始め、修飾キーの誤爆が多ければ長く、タップになってしまうなら短くする

Hold On Other Key Pressは長押しを強く優先する設定なので、親指キーのLTなどには向きますが、ホームロウモッドに入れると速く打った文字が修飾キーに化けます。タップダンスでホームロウモッドを組むのも避けてください。タップダンスの判定はMod-Tapより単純な仕組みで、マニュアルも向かないと書いています。

Vial対応ファームの確認と書き込み

対応状況の確認：keymaps/vialフォルダの有無

自分のキーボードがVialに対応しているかは、vial-qmkリポジトリの keyboards/ 以下で、そのキーボードに vial という名前のkeymapフォルダがあるかで判断できます。公式のルールでVialへ移植したkeymapは必ず vial と名付けるので、名前で一意に探せます。GitHubのコード検索（filename:vial.json repo:vial-kb/vial-qmk）では528件が見つかります（2026年10月12日時点）。フォルダが無い場合も、メーカーが独自に配布していることがあるので販売ページを確認してください。

書き込み方法：マイコンごとの使い分け

書き込み手順はVialではなくキーボードのマイコンとブートローダーで決まります。

QMK ToolboxはWindowsとmacOS向けのアプリです。VialアプリのFirmware updaterタブは、vibl搭載のキーボードをつないだときだけ表示されます。RP2040は Raspberry Pi Pico W にも載っているマイコンで、BOOTSELボタンを押しながらUSBを挿すとUF2ブートローダーに入ります。リセットのダブルタップで入れるのは、ファームでその機能を有効にしたボード（Pro Micro RP2040は既定で有効）だけです。リセットボタンが無いキーボードでも、ファームでBootmagicが有効なら、指定キー（既定はマトリクスの[0,0]、多くはEsc）を押しながらUSBを挿すとブートローダーに入れます。ただし標準のBootmagicはEEPROMも初期化するため、実行前にVialの設定を.vilファイルへ保存してください。

自作キーボードをVialに対応させる手順（vial-qmkでのビルド）

ビルド環境の準備：QMK本家とは別フォルダにclone

まずQMK本家の手順でQMK CLIを入れます。WindowsはQMK MSYS、macOSとLinuxは curl -fsSL https://install.qmk.fm | sh です。そのうえでvial-qmkを本家の qmk_firmware の外側にcloneします（中に入れ子にすると不具合が出ると公式が明記しています）。Git が必要です。

git clone https://github.com/vial-kb/vial-qmk
cd vial-qmk
make git-submodule
qmk doctor
make vial_example/vial_atmega32u4:default

qmk doctor で「upstream が設定されていない」という警告が出るのは、本家リポジトリではないためで問題ありません。ビルドは qmk compile ではなく make を使ってください。qmk compile を別の場所で実行すると本家QMKのファームがビルドされます。qmk env の QMK_HOME が vial-qmk を指しているかも確認し、違えば qmk config user.qmk_home=<vial-qmkのパス> で直します。

keymaps/vialの構成：keymap.cと3つの設定ファイル

既存の keymaps/default をそのまま keymaps/vial にコピーし、次の3ファイルを足します。

# keymaps/vial/rules.mk
VIA_ENABLE = yes
VIAL_ENABLE = yes

/* keymaps/vial/config.h */
#pragma once
#define VIAL_KEYBOARD_UID {0xXX, 0xXX, 0xXX, 0xXX, 0xXX, 0xXX, 0xXX, 0xXX}
#define VIAL_UNLOCK_COMBO_ROWS { 0, 2 }
#define VIAL_UNLOCK_COMBO_COLS { 0, 13 }

• rules.mk：2行とも必須で、VIA_ENABLEを消してはいけません。キーボード直下の rules.mk には書かず、keymaps/vial 側に書きます。
• config.h：UIDは vial-qmk の直下で python3 util/vial_generate_keyboard_uid.py を実行して生成します。UIDは機種ごとに1つで、個体ごとに変える必要はありません。UNLOCK_COMBOは解除に使うキーの行・列で、上の例は公式ガイドの配列におけるEsc[0,0]とEnter[2,13]です。座標は機種ごとに異なるため、自分のキーボードのマトリクスに合わせて置き換えてください。
• vial.json：キーの物理配置の定義です。VIA用の定義JSONを流用できます。

最後に make <キーボードのパス>:vial でビルドし、前章の方法で書き込みます。

「firmware is too large」への対処

Vialは既定で全機能を有効にするため、Pro MicroのようなAVRマイコンではフラッシュやEEPROMが足りなくなりがちです。公式の例では The firmware is too large! 30768/28672 (2096 bytes over) と表示されます。削る候補は次のとおりです。表のconfig.h向け設定は略記で、実際には各行の先頭に #define を付けます（例：#define DYNAMIC_KEYMAP_LAYER_COUNT 2）。x は希望するスロット数の整数に置き換えてください。

QMK_SETTINGSを切ると前述のTap-Hold設定をGUIで変えられなくなるので、先にLTOと使わない機能の無効化を試してください。ブートローダーをCaterina（約3,500バイト）から512バイトのnanoBootに替える方法もありますが、ISPライターが要り、配布先の利用者も同じ交換を強いられます。

vial-qmkが追従しているQMKの版

vial-qmkは本家QMKを定期的に取り込むフォークです。コミット履歴を見ると、vialブランチに最後に統合された取り込みは2025年6月21日時点の本家（作業ブランチ merge-2025-06-21、2025年7月12日のマージコミット967967eで統合）です。2025年12月28日時点の本家を取り込む merge-2025-12-28 ブランチは、2026年10月12日時点でもvialブランチより445コミット先行したまま統合されていません。このため、本家の最新版向けに書かれたキーボード定義をコピーすると、ビルドが通らないことがあります。

セキュリティロックの仕組みとVIAL_INSECUREを避ける理由

Vialには、悪意のあるソフトが入ったPCにキーボードのファームやマクロを勝手に書き換えられないための「ロック」があります。キーボードはロック状態で起動し、アプリの Security → Unlock を選ぶと、config.hで指定したキーを数秒間押し続けるよう求められます。ロック中は次の操作ができません。

• マクロの変更
• ブートローダーへの切り替え（ファームの書き換え）
• RESETキーコードの割り当て

監視ソフトが入った会社のPCでは解除しないよう公式が注意しています。再ロックはキーボードの抜き差しか Security → Lock です。

rules.mkに VIAL_INSECURE = yes を書けばロック自体を無効にできますが、この設定のキーボードはvial-qmkの本体リポジトリに受け入れられません。解除キーの設定が面倒という理由だけでINSECUREにするのはやめるべきです。公式ガイドは、解除キーを2つ以上にし、複数レイアウトのキーボードではどのレイアウトにも存在するキーを選ぶよう求めています（例はEscとEnter）。

認識されない・書き込めないときの切り分け

Matrix testerタブでは、押したキーが画面上で色付きになるので、配線とスイッチの問題か、キーマップの問題かを切り分けられます。このタブはロックを解除しないとテストを始められません（vial-guiのソースで、未解除のときはUnlockボタンを表示する作りです）。

Lightingタブが出ない場合は、ファームの照明機能とvial.jsonのlighting設定を確認してください。PC側からキーボード以外のRGB機器とまとめて制御したい場合は OpenRGB のような別系統のツールを使います。

よくある質問

Vialは無料ですか？対応OSは？

無料です。GPL-2.0のオープンソースで、アプリはWindows（インストーラー・ポータブル版）、macOS（dmg）、Linux（AppImage）向けに配布されています。Web版のvial.rocksはOSを問わず、WebHID対応ブラウザで動きます。

VIA対応キーボードはそのままVialで使えますか？

公式マニュアルによると、VIA用ファームのままではVialに認識されないか、一部の機能しか使えません。デスクトップ版には File → Sideload VIA JSON や Download VIA definitions といったVIAの定義を読み込むメニューがありますが、タップダンスなどVialの機能を使うにはVial対応ファームへの書き換えが必要です。対応ファームはメーカーの配布物か、vial-qmkの keymaps/vial から入手します。

Vialで変更した設定はどこに保存されますか？

キーボード本体に保存されます。キー割り当ては即座に保存されますが、マクロなどの編集にはSave操作が必要です。保存済みの配列は別のPCにつないでも保持されます。バックアップとして File → Save current layout で .vil ファイルに書き出しておけば、ファームを書き直した後に読み込んで戻せます。

Vialのweb版（vial.rocks）の使い方は？

Chrome・Chromium・Edgeで vial.rocks を開き、「Start Vial」を押して表示されるデバイス一覧からキーボードを選びます。キーマップ編集などの画面はアプリ版と同じです。違いは、最初にブラウザへUSB機器へのアクセスを許可することと、VIA定義の読み込み（Sideload VIA JSONなど）がデスクトップ版に限定されることなどです。また、Record macroはWindows・Linuxのデスクトップ版でのみ利用できます。

Bluetoothの無線キーボードでもVialは使えますか？

ファームによります。Vialはvial-qmkのほか、Vialでの編集に対応したRMKでも使え、RMKはBLE接続のまま無線で編集できます。無線の自作キーボードで多いZMKファームには使えず、その場合はZMK Studioでキーマップを変えます。

関連記事

• Raspberry Pi Pico Wとは？基本仕様・モデルの違い・できることを総まとめ
• OpenRGBの使い方と安全性｜1.0正式版の導入手順・日本語化・DDR5のSPD破損リスク
• arduino-cliとは？インストールからコンパイル・書き込み・CI自動化まで実践ガイド
• Gitの最新バージョンは？確認・アップデート方法とGit 2.55の新機能【2026年最新】