https://github.com/aviscaerulea/vdskswtch
CLI tool to switch Windows 11 virtual desktops with pre/post script hooks
https://github.com/aviscaerulea/vdskswtch
automation cli cpp virtual-desktop windows windows11
Last synced: about 2 months ago
JSON representation
CLI tool to switch Windows 11 virtual desktops with pre/post script hooks
- Host: GitHub
- URL: https://github.com/aviscaerulea/vdskswtch
- Owner: aviscaerulea
- License: mit
- Created: 2026-03-31T18:56:56.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-04-05T03:57:05.000Z (3 months ago)
- Last Synced: 2026-04-05T05:22:41.814Z (3 months ago)
- Topics: automation, cli, cpp, virtual-desktop, windows, windows11
- Language: C++
- Homepage:
- Size: 106 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# vdskswtch
Windows 11 の仮想デスクトップを切り替える CLI ツール。
メインとミーティング用の 2 つの仮想デスクトップを管理する。
ミーティング用デスクトップが存在しない場合は自動作成して切り替え、
不要になったら削除してメインに戻る。
## 動作要件
- Windows 11 24H2（ビルド 26100 以降）
## インストール
[Releases](https://github.com/aviscaerulea/vdskswtch/releases) から最新の zip を取得し、
`vdskswtch.exe` をパスの通ったディレクトリに配置する。
## 使い方
```
vdskswtch ミーティング用デスクトップに切り替え（switch のエイリアス）
vdskswtch switch [name] ミーティング用デスクトップに切り替え（なければ作成）
vdskswtch close [name] ミーティング用デスクトップを削除してメインに戻る
vdskswtch version バージョンを表示
vdskswtch help ヘルプを表示
```
デスクトップ名のデフォルトは `Meeting`。`name` で任意の名前を指定できる。
## 使用例
```bash
# ミーティング用デスクトップに切り替え（なければ "Meeting" という名前で作成）
vdskswtch
# 同上（明示的に switch コマンドを使う場合）
vdskswtch switch
# "Work" という名前のデスクトップに切り替え（なければ作成）
vdskswtch switch Work
# ミーティング用デスクトップを削除してメインに戻る
vdskswtch close
```
## 設定ファイル
`vdskswtch.exe` と同じディレクトリに `vdskswtch.toml` を配置すると、
デスクトップ切り替え時にスクリプトを自動実行できる。
```toml
# switch 前に実行するコマンド
pre_exec = []
# switch 後に実行するコマンド
post_exec = ["C:\\scripts\\start-meeting.bat"]
# close 時（デスクトップ削除前）に実行するコマンド
close_exec = ["C:\\scripts\\end-meeting.bat"]
# 全仮想デスクトップにピン留めするプロセス名（大文字小文字不問）
# 注意：ウィンドウ単位でのピン留めのため、アプリ再起動後は新しいウィンドウのピン留めが解除される
pin_apps = ["Teams.exe", "Zoom.exe"]
```
`vdskswtch.local.toml` を配置すると `vdskswtch.toml` の設定を上書きできる。
## 注意事項
- undocumented な Windows 内部 API を使用しているため、Windows Update により動作しなくなる場合がある。
- switch/close コマンドは同時に 1 つのインスタンスのみ実行できる。既に実行中の場合は Toast 通知を表示して終了する。