Soyokazeマニュアル

Soyokaze マニュアル

概要

Soyokazeはbluewindというコマンドラインランチャーの代替として使えるよう作成しているツール
bluewindの使用感を維持しつつ、現行のWindows環境でも動作するコマンドラインランチャーを実現することを目的としている。

動作環境

Windows環境で動作する。以下の環境で動作確認済

セットアップ

インストール

  1. zipをファイルを展開して任意のフォルダに展開する
  2. 展開先フォルダにあるsoyokaze.exeを実行する
  3. 設定はユーザーフォルダ(たいていは C:/Users/(ユーザー名))直下の.soyokazeフォルダに保存される
    初回実行時に.soyokazeフォルダを作成する

アンインストール

アンインストーラはないため、以下すべてを手動で行う。

  1. タスクトレイ上のコンテキストメニュー-アプリケーションの設定-基本-ショートカット設定を表示し、作成したショートカットをすべてを削除するを押下する
  2. soyokaze.exeを終了する
  3. インストール時にsoyokaze.exeを置いたフォルダを削除する
  4. 設定フォルダ (C:/Users/(ユーザー名)/.soyokaze)を削除する

バージョンアップ

  1. 本アプリを実行している場合は終了する
  2. 実行ファイルを置いたフォルダ内のファイルをすべて上書きする

アプリケーションの設定情報の保存先については設定ファイルの保存先を参照のこと

基本的な使い方

アプリの起動

コマンドの実行

コマンドの登録方法

本アプリでは以下の方法でコマンドを登録することができる

各方法の詳細について後述する。

newコマンドで登録する

入力画面からnewコマンドを実行すると、コマンドの種類を選択する画面が表示される。
↓

コマンド種別を選択し、OKボタンを押下すると、選択した種別に応じたコマンド編集画面が表示される。
↓※ 通常コマンドのコマンド編集画面

コマンド編集画面で新規登録キーワードや紐づけるプログラムへのパスなどの情報を入力し、OKを押すと、コマンドとして登録される。

registwinコマンドで登録する

入力画面からregistwinコマンドを実行すると、直前にアクティブになっていたウインドウの実行プロセスを登録する画面が表示される。
↓

対象ウインドウをDrag&Dropする

入力画面のアイコン欄をドラッグして、登録したいウインドウにドロップすると、そのウインドウの実行プロセスを登録する画面が表示される。
↓

コンテキストメニューの送る>コマンドとして登録する

アプリケーション設定の基本＞ショートカット登録 から「送る」から登録できるようにするをチェックしている場合、エクスプローラの送るに登録用のメニュー項目が表示される。

登録したいファイルをエクスプローラ上で右クリックして、送る>コマンドとして登録するを選択すると、そのファイルを登録するためのコマンド編集画面が表示される
↓

入力画面

概要

ランチャーアプリを実行すると表示される画面。
この画面でキーワードを入力し、Enterキーを押下すると、キーワードに関連付けた各種操作を実行できる。
また、Tabキーを押すと、入力中のキーワードを補完することができる。

画面

画面の説明

この画面がでているときにF1キーを押下すると、マニュアル(このファイル)を開く。

キーワードマネージャ

本アプリに登録したコマンドの管理(追加/編集/削除)をするための画面。

下記のいずれかの操作を行うと、キーワードマネージャーを表示することができる。

画面

画面の説明

コマンド種類選択

概要

作成するコマンドの種類を選択するための画面。
コマンドの種類を選択して、OKボタンを押下すると、選択したコマンドの新規作成画面を表示する。

各コマンドの説明については コマンドの説明 を参照のこと

画面

アプリケーション設定

概要

アプリケーションの動作に関する設定を行うための画面。

下記のいずれかの操作を行うと、アプリケーション設定を表示することができる。

基本

概要

ランチャーの基本動作にかかわる設定をする画面
主に入力画面を表示する際の動作の設定を行う。

画面

基本＞ショートカット登録

概要

各種ショートカット登録をするための画面
いずれもチェックすると登録され、チェックを外すと登録が解除される

画面

基本＞効果音

概要

画面操作時に効果音を鳴らす設定をするための画面
もし、音を鳴らせる環境で作業しているのであれば、気分が上がる効果音を設定すると、作業効率がアップするかもしれない。

mp3ファイルのみ指定可能(他の音声ファイルには非対応)

画面

入力

概要

入力画面のキーワード入力回りの動作に影響する設定を行うための画面

画面

入力＞キー割り当て

概要

入力画面の操作に関するキーを設定する画面
独自のキーバインドで上下左右の移動や決定操作を行うアプリケーションがある。(例: EmacsのCtrl-N Ctr-P Ctrl-Mなど）。
それらのアプリの使用感に寄せるための設定

画面

入力＞履歴

実行

実行＞パス

ファイル名を指定して実行 コマンドにおける、実行ファイルを検索するフォルダを追加で指定することができる。
検索の優先順位としては環境変数PATHで設定されたフォルダ、次に追加のディレクトリ、の順で検索を行う。
リストの上にある項目が優先される。

実行＞除外するファイル

ファイル名を指定して実行 コマンドにおいて、対象外とするファイルを指定することができる。

実行＞優先度

コマンドの優先度を設定することにより、候補欄に表示されるコマンドの順序を制御するための画面。

優先度の例

たとえば、下記の設定がされていた場合、 入力欄に「b」と打った場合に、bookmark blog-hatena board の順に表示される。

コマンド 優先度
blog-hatena 5
board 0
bookmark 10
制限事項

表示

入力画面の外観にかかわる設定を行う。

表示＞配色

拡張機能

拡張機能＞ウインドウ切替

ウインドウ切替関連機能に関する設定を行う画面

拡張機能＞クリップボード履歴

クリップボード履歴機能に関する設定を行う画面

拡張機能＞パス変換

その他

選択肢 説明
なし ログを一切出力しない
エラー エラーログのみ出力する
警告 エラーと警告ログを出力する
通常 エラーと警告と通常ログを出力する
デバッグ デバッグ用出力も含めたすべてのログを出力する

その他の画面

アプリ表示用ホットキー

ランチャーアプリの入力ウインドウを呼び出すためのキー設定画面

キー割り当て

コマンドに対するキー割り当てを行うための画面。
割り当てたキーを押すとコマンドを実行することができる。

ホットキーの種別について
ホットキーの種別の比較

それぞれ実現している仕組みが異なる。
常駐時いつでも有効はシステムのホットキーに登録するため、登録したキーを使って、いつでも呼び出せる一方で、ほかのアプリ内においてそのキーを使うことができなくなる

種別 メリット デメリット
アクティブ時のみ有効 他アプリに干渉しない
他アプリへの干渉を気にする必要がないのでキー選択の幅が広い		 まずアクティブにする(入力画面を表示する)必要がある
アクティブ時のみ有効(SandS) SandSの修飾キーをランチャー呼び出しキーの修飾キーと合わせることにより、スムーズな運指が実現できる まずアクティブにする(入力画面を表示する)必要がある
常駐時いつでも有効 いつでも呼び出せる 登録したキーを他アプリで使えなくなってしまう
他アプリに干渉することをふまえて割り当てるキーを慎重に選択する必要がある
SandSに関する制限事項

タスクトレイ

本アプリを起動すると、タスクトレイにアイコンが表示される
↓

アイコンを右クリックすると、メニューが表示される
↓

なお、入力画面のコメント表示欄を右クリックした場合にも、上記のメニューが表示される

コマンドの説明

ここでは、ランチャーアプリで作成可能なコマンドについて説明する。

現在、下記18種類のコマンドを作成することができる。

通常コマンド

通常コマンドはファイルやURLを関連付けられたプログラムで表示するためのコマンドである。
よく使うプログラムやファイル、URLに対して任意の名前を設定し、その名前を使って簡単に呼び出すことができる。

通常コマンド 基本設定

設定画面

通常コマンド 環境変数

起動するプログラムに対して環境変数を追加定義することができる。
既存の環境変数と同じ名前を定義した場合は値を上書きする。

通常コマンド その他

実行時の動作
押下キー 動作
Enter ファイルを実行する or ディレクトリを開く
Ctrl-Enter パス(ファイルが存在するディレクトリ)を開く
Shift-Ctrl-Enter 管理者権限で実行する

定型文

あらかじめ登録しておいた定型文をクリップボードにコピーするためのコマンド
よく使う言い回し(定型文)に名前を付けて、その名前で定型文を呼び出すことができる。

設定画面

実行時の動作
押下キー 動作
Enter 設定されたテキストをクリップボードにコピーする

定型文グループ

定型文のグループを定義するためのコマンド
入力欄にグループ名を登録すると、そのグループに登録した定型文の一覧が候補として選択される。 候補を選択すると、その定型文がクリップボードにコピーされる。 あらかじめ登録しておいた定型文をクリップボードにコピーするためのコマンド

よく使う言い回し(定型文)に名前を付けて、その名前で定型文を呼び出すことができる。

設定画面

定型文の編集画面

実行時の動作
押下キー 動作
Enter 設定された定型文をクリップボードにコピーする

Web検索コマンド

Web検索を行うためのコマンド。
GoogleやTwitterなどの検索に対して名前を付けて、その名前で検索サイトを使い分けることができる。
例えば、Google検索にgという名前を付けて、g (検索ワード) で検索を実行できる。

設定画面

実行時の動作
押下キー 動作
Enter ブラウザで検索を実行する

ブックマーク検索コマンド

Webブラウザのブックマークを検索するためのコマンド。
検索ワードを含むタイトルやURLのブックマークを候補として表示できる。
該当する候補を選択して実行すると、ブックマークをブラウザで開く。

Edge/Chromeに対応している。

なお、javascript:で始まるブックマーク(ブックマークレット)については候補から除外する。

例

c++というワードを含むブックマークを表示する

設定画面

実行時の動作
押下キー 動作
Enter ブックマークをブラウザで開く
Shift-Enter URLをクリップボードにコピーする

ブラウザ履歴コマンド

Webブラウザの閲覧履歴を検索するためのコマンド。
検索ワードを含むタイトルやURLの履歴を候補として表示できる。
該当する項目を選択して実行すると、履歴のページをブラウザで開く。

Edge/Chromeに対応している。

設定画面

実行時の動作
押下キー 動作
Enter 該当するページをブラウザで開く
Shift-Enter URLをクリップボードにコピーする

グループコマンド

本アプリに登録済のコマンドを複数まとめて実行するためのコマンド
決まった順序で実行する複数の操作を呼び出す用途で使うことができる。

設定画面

- 上の図の場合、xxx→vim→twitterという順にコマンドを順次実行する、という意味 - 完了するまで待つにチェックすると、そのコマンドが完了するのを待つ

実行時の動作
押下キー 動作
Enter 登録された内容を実行する

DirectoryIndexコマンド

(試作)

Directory Index(Webサーバーのインデックスページ)上のディレクトリやファイルを表示するコマンド
ランチャーのUI上からディレクトリやファイルをインクリメンタルに絞り込んで、階層をたどることができる

例


↓

設定画面

実行時の動作
押下キー 動作
Enter 選択した候補のリンク先へ遷移する
Shift-Enter 選択した候補のリンク先をブラウザで開く
Ctrl-Enter 選択した候補のリンク先URLをクリップボードにコピーする

正規表現コマンド

指定した正規表現パターンに合致する場合に、その内容に応じてコマンドを実行するためのコマンド

他のコマンド種類と異なり、登録した名前(キーワード)でマッチングを行うのではなく、パターンで指定した正規表現によるマッチングを行う。
正規表現にマッチしたときにキャプチャしたものを$1``$2…で参照し、起動するコマンドに渡すことができる。

設定画面

実行時の動作
押下キー 動作
Enter コマンドで設定したファイルを実行する

フィルタコマンド

ファジーファインダー的なことをするためのコマンド。以下のようなことを行う。

前段の処理を実行する
↓
前段の処理が標準出力に出力した内容を行単位に分けて候補とする
↓
候補の一覧を候補欄に表示する(利用者は絞り込み・選択を行う)
↓
選択した結果をもとに後段の処理を実行する

登録したコマンド名を入力欄に入力すると、外部プログラムの実行を行い、得られた出力を候補欄に表示する

コマンド名(上の例だとfolderselect)をタイプした時点で、前段の処理を実行し、候補の一覧を生成・表示する

設定画面

候補の生成方法 - プログラムを実行する

候補の生成方法 - 候補を定義する

実行する処理 - 他のコマンドを実行する

実行する処理 - プログラムを実行する

実行する処理 - クリップボードにコピーする

おことわり

コマンドの設定次第で、候補の数が多くなる可能性がある。
その場合において、大量のデータを高速に絞り込むことを意識した実装などは全くしてないので、大量データを扱うならしかるべきツールを使うのが吉
(このコマンドはインクリメンタルな絞り込みをする手段をお手軽に提供するためのものなので..)

実行時の動作
押下キー 動作
Enter 選択した候補を使って、コマンド設定で指定した後段の処理を実行する

ウインドウ切替コマンド

任意のウインドウをアクティブにする(前面に出す)ためのコマンド。
検索条件をあらかじめ設定しておき、それに対してキーワードやホットキーを設定することができる。

よく使うアプリのウインドウを登録しておけば、そのアプリに素早く切り替えることができる。

タイトルとウインドウクラス名でウインドウを識別する。
対象とするウインドウのタイトルとウインドウクラス名を手入力するのは難しいので、画面上のアイコンを対象ウインドウにドラッグするのがおすすめ。

ウインドウ選択切替という、名前が似た別の機能もある。

設定画面

実行時の動作
押下キー 動作
Enter ウインドウを切り替える
Ctrl-Enter ウインドウを切り替えて最大化する
例

前述の画面の設定でコマンドを作っておくと、下記の操作のいずれかでGVimのウインドウに切り替えることができる。

Windows標準のウインドウ切り替えのキー操作であるAlt-Tabの場合、その時々のウインドウの表示状態によりキーを操作する回数が変わる、ウインドウの数が増えると目的のものを探すのに時間がかかる、という問題がある。
このコマンドを使うと、定数時間で切り替えることができるのがメリット

ウインドウ整列コマンド

ウインドウの位置とサイズを指定しておいて、一括設定するためのコマンド。
普段よく使うアプリの「いつもの配置」を登録しておけば、それをすぐに再現することができる。

任意のウインドウに対し、位置・サイズ指定、最大化、最小化、非表示を設定することができる。
非表示にすることもできるので、バックグラウンドで実行する必要がある一方で表示しておきたくないウインドウを隠す、という用途で使うこともできる。

設定画面

例

電卓とペイントをあらかじめ決めた位置に並べる

実行時の動作
押下キー 動作
Enter ウインドウの整列を実行する

整列対象とするウインドウを登録する

ウインドウ整列コマンドに登録するためのウインドウの情報を入力するための画面。

タイトルとウインドウクラス名でウインドウを識別する。
対象とするウインドウのタイトルとウインドウクラス名を手入力するのは難しいので、画面上のアイコンを対象ウインドウにドラッグするのがおすすめ。

設定画面

簡易辞書コマンド

Excelワークブックファイル(*.xlsx,*.xls)の任意の範囲のデータを簡易的な辞書データ(キーと値のペアの集合)として利用するコマンド。
Excelで定義した辞書データをインクリメンタルに検索することができる。

Excelをデータソースにできるので、データのメンテナンスをExcelでお手軽にできるのがメリット

Excelを利用するため、実行環境にExcelがインストールされている必要がある。

用途・活用例
設定画面

なお、逆引き検索でヒットした場合、$keyと$valueも逆になる

実行する処理 - 他のコマンドを実行する

実行する処理 - プログラムを実行する

実行する処理 - クリップボードにコピーする

簡易辞書コマンド 設定の手引き
  1. Excelアプリケーションを起動し、辞書として利用したいワークシートを選択しておく
  2. Excel側でキーとして使うセル範囲を選択する。次に、本アプリ側でキー範囲取得ボタンを押す
  3. Excel側で値として使うセル範囲を選択する。次に、本アプリ側で値範囲取得ボタンを押す
  4. 取得内容確認ボタンを押下し、取得されるキーと値の内容を確認する
  5. キーと値の内容に問題なければ、選択後の処理の設定をして、OKボタンを押下してコマンドを作成する
動作の説明
制限事項
実行時の動作
押下キー 動作
Enter コマンド設定画面で指定したアクションを実行する
(コピー or 他のコマンド実行 or プログラム実行)
Shift-Enter キーをコピー
Ctrl-Enter 値をコピー

フォルダ更新検知コマンド

任意のフォルダを監視し、フォルダ内のファイルの変更を検知したときに通知してくれるコマンド。

ファイルサーバ上にあるフォルダに何らかの変更があったときに、それを知ることができる。

設定画面

動作の説明
実行時の動作
押下キー 動作
Enter 更新検知対象のパスを開く

音量調節コマンド

サウンドデバイスの音量やミュート状態を変更するためのコマンド。
下記の操作が可能

コマンド実行時点でシステムで選択されているサウンドデバイスに対して適用する。
(複数のサウンドデバイスがある状況で任意のデバイスに対して…という機能はない)

設定画面

実行時の動作
押下キー 動作
Enter 設定した内容に基づき音量調節を実行する

【試作】取り外しコマンド

CD/DVD等ディスクドライブのトレイを開いたり、USBメモリのようなリムーバブルドライブの取り外しを行うためのコマンド

コマンド作成時点であらかじめ対象とするドライブ(A:～Z:)を設定しておき、 コマンド実行時点においての当該ドライブに対して、取り外し操作を試みる。

設定画面

実行時の動作
押下キー 動作
Enter 設定した内容に基づき取り外し操作を行う

振り分けコマンド

コマンドを実行したときのEnterキーの押下状態(修飾キーの組み合わせ)に応じて、異なるコマンドを実行できるようにする

このコマンドを使うと、Enterキーのみを押してコマンドを実行した場合と、Shift-EnterキーやCtrl-Enterキーを押した場合で異なるコマンドを実行させることができる

フィルタコマンド と組み合わせて使用することを想定している。
一つのフィルタコマンドに対して、キーの押し方によって異なるアクションを割り当てることができる。

設定画面

実行時の動作

割り当てたキーとコマンドの関連付けに従う

メモ

エイリアスコマンド

入力欄に任意の文字列を入力(+実行）することができるコマンド。

このコマンドを使うと、コントロールパネルやUWPアプリなど、 実行環境に入っているものに対して任意の名前をつけたり、ホットキーを割り当てて実行したりできる。

設定画面

例

例えば、前セクションの設定画面の場合、"Windows Update > Windows Update"という文字列が入力欄に入力・実行される。
すると、Windows Updateの設定画面を表示することができる。(Windowsの設定コマンド を有効にしている必要あり)
↓この画面

実行時の動作
押下キー 動作
Enter コマンドを実行する
メモ

システムコマンド

システムコマンドは、本アプリに最初から登録済のキーワード

削除はできないが、一部のコマンドについては無効化することができる。
無効化すると、入力画面でキーワードを入力しても候補として表示されず実行もできなくなる。

キーワードマネージャから設定することができる。

cd

実行中のランチャーアプリプロセスのカレントディレクトリを変更する

copyclip

コマンド名の後に指定した文字列をクリップボードにコピーする

displayoff

モニター(ディスプレイ)の電源を切る。
マルチモニター環境の場合、すべての電源を切る。

edit

既存コマンドの編集画面またはキーワードマネージャ画面を表示する
後続パラメータにコマンド名を表示を指定した場合、そのコマンドの編集画面を表示する。
後続パラメータとして何も指定しなかった場合はキーワードマネージャ画面を表示する。

例

emptyrecyclebin

ごみ箱を空にする。
コマンド設定にて、空にする前の確認の有無を設定することができる。(初期状態は確認なし)

exit

本アプリを終了する。

maindir

本アプリの実行ファイルが置かれているフォルダをエクスプローラーまたはファイラーで表示する。

アプリケーション設定 で外部ファイラーを設定している場合は外部ファイラーで開く。
設定していない場合はエクスプローラーで開く。

manager

キーワードマネージャ画面を表示する。

new

新規コマンド登録画面を表示する。

newsnippet

現在クリップボードにあるテキストを定型文として登録するための登録画面を表示する。

registwin

直前にアクティブなウインドウをコマンドとして登録する。

reload

設定ファイルの再読み込みを行う。
(テキストエディタで直接キーワード編集を行ったときにリロードするためもの)

当アプリの初期のバージョンではコマンド編集のためのUIを実装していなかったため、その頃の名残として存在しているものであるが、現在は使う必要はない。

restart

アプリの再起動を行う。

初期状態では無効になっている。キーワードマネージャのコマンド設定画面から有効にすると使用できる。

setting

アプリケーション設定画面を表示する。

userdir

設定ファイルの保存先フォルダをエクスプローラーまたはファイラーで表示する。

アプリケーション設定 で外部ファイラーを設定している場合は外部ファイラーで開く。
設定していない場合はエクスプローラーで開く。

設定ファイルの保存先については 設定ファイルの保存先 を参照のこと

version

バージョン情報ダイアログを表示する

システムコマンドの編集

一部のシステムコマンドは機能を無効化することができる。
無効化すると、入力欄にコマンド名を入力しても候補として表示されなくなる。

キーワードマネージャ上でシステムコマンドを選択し、編集ボタンを選択すると下記の画面が表示される。

コマンドとして登録していなくても実行できる機能

利用者が自分でコマンドを登録しておき、それを使うのが本アプリの基本的な使い方であるが、 コマンドとして登録していなくても使える機能がある。

電卓

入力欄に数式を入れると、計算結果をコメント欄に表示する。
Enterキーを押下すると、計算結果をクリップボードにコピーできる。

利用するにはPythonが必要。
Pythonを使っているので、演算子もPythonのものを使うことができる。

その他、Python標準関数のうち、計算結果が文字列/数値になるものと、mathモジュールの関数を使用することができる。

URIデコード

URIエンコード形式の文字列をデコードして表示する。 (UTF-8でエンコードされているものとして解釈する)
コマンドを実行するとデコード後の文字列をクリップボードにコピーする。

例: %E3%81%93%E3%82%93%E3%81%AB%E3%81%A1%E3%81%AF → こんにちは

環境変数の値を見る

環境変数の値を調べるための機能。利用方法として以下の2種類がある。

  1. %環境変数名%の形式で入力欄に入力する
    その環境変数の値をコメント表示欄に表示する。
    また、実行すると、環境変数の値をクリップボードにコピーする。
  2. プレフィックスを入力する
    プレフィックス(デフォルト値:env)を入力すると環境変数の一覧が候補欄に表示される。

    プレフィックスはアプリ設定で変更することができる。

Base64デコード

Base64形式の文字列をデコードして表示する。 コマンドを実行するとデコード後の文字列をクリップボードにコピーする。

例: 44GT44KT44Gr44Gh44Gv77yB → こんにちは！

このコマンドではデコード後のデータをUTF-8形式の文字列として解釈する。 UTF-8形式の文字列として解釈できないものは表示しない。

なお、誤発動を防止するため、入力キーワードが16文字未満の場合には変換を行わない。

8進数/16進数/Unicodeエスケープシーケンス

8進数/16進数/Unicodeエスケープシーケンスで記述された文字列をデコードして表示する。 (8進数/16進数でエスケープされたものについてはUTF-8のバイトシーケンスとして解釈する)
コマンドを実行するとデコード後の文字列をクリップボードにコピーする。

IPアドレス

getipコマンドを入力すると、実行環境で利用可能なネットワークアダプタのIPアドレスの一覧を表示する。
コマンドを実行するとIPアドレスをクリップボードにコピーする。

簡易時間計算

HH:MM-HH:MMの型式で入力すると、時間間隔を分単位で表示する。
コマンドを実行すると時間をクリップボードにコピーする。

例: 13:43-12:50 → 53分

単位変換

以下の単位変換を実装している。

西暦和暦変換

西暦(グレゴリオ暦)と和暦の相互変換機能。
変換結果をクリップボードにコピーすることができる。

令和/平成/昭和/大正/明治までを扱うことができる。

例

16進カラーコード

#RRGGBB #RGB rgb(r,g,b)の形式で入力欄に入力すると、そのカラーコードに対応する色をアイコン欄に表示する。 選択するとクリップボードに内容をコピーする。

URLを開く

http:/...またはhttps://...で始まるURLを入力欄に直接入力して実行すると、通常使うブラウザでURLを開くことができる。

メールを送る

mailto:の後にメールアドレスを入力欄に入力して実行すると、そのメールアドレスをあて先として標準のメーラーが起動する。

ファイル名を指定して実行

入力欄に入力したキーワードが、環境変数PATHに含まれるフォルダやアプリで独自に追加したフォルダ内の.exeファイルと一致する場合は、 その実行ファイルを起動する。

例えば、notepadと入力すると、その環境のPATHのどこかにnotepad.exeがある場合、それを実行することができる。 (一般的にはC:\WINDOWS\system32\notepad.exeにヒットするはず)

履歴

コマンドとして登録していないURL、プログラム実行、実行時引数を伴うコマンド実行は履歴として登録される。 履歴として登録されたものは、次回以降のキーワード入力の際に部分一致で候補にあがるようになる。

VMware Workstation PlayerのMRU

VMware Workstation Playerの起動直後の画面の一覧に表示される仮想マシンの表示名を候補として表示する。
実行すると、拡張子.vmxに関連付けられたアプリケーションでファイルを実行する。
(VMware Workstation Playerが仮想マシンを起動するはず)

Excel/Libre Office Calcシート表示

入力画面を表示した時点で開いているExcel(デスクトップ版)とLibreOffice Caclのシート名一覧を候補に表示する。
該当する項目を入力画面から実行すると、対応するワークシートのウインドウをアクティブにする。

Ctrl-Enterキーを押して実行すると、最大化表示する。

PowerPoint スライド表示

入力画面を表示した時点でアクティブなPowerPointプレゼンーションのスライドタイトル一覧を候補に表示する。
該当する項目を入力画面から実行すると、対応するスライドのアクティブにする。

ウインドウ選択切替

入力画面を表示した時点で表示しているウインドウタイトルの一覧を候補として表示する。
該当する候補を実行すると、対応ウインドウをアクティブにする。

Ctrl-Enterキーを押して実行すると、最大化表示する。

登録型のコマンドであるウインドウ切替コマンドとは別物。
ウインドウ選択切替はキーワードを入力した時点で存在しているウインドウのうち、合致するタイトルを持つウインドウを候補として表示する。
一方、ウインドウ切替コマンドはよく使うウインドウを指定して、任意のキーワードやホットキーで切り替えられるようにするためのもの。

ウインドウに一時的な名前を付ける

コンテキストメニューからウインドウに一時的な名前を付けるを選択すると、ウインドウに対して一時的な名前を付与することができる。

名前を付けると、付与した名前でウインドウを切り替えることができる。

なお、付与した名前とウインドウの紐づけは本アプリを終了するか、ウインドウが破棄されると失われる。

想定用途

同じアプリのウインドウを異なる目的で複数表示しているような状況において、ウインドウごとにわかりやすい名前をつけて、その名前で呼び出せるようにする、みたいなものを想定
例えば、複数のテキストエディタをコード表示用/メモとり用で分けている、のような・・

コントロールパネル表示

コントロールパネルの表示名を候補として表示する。
(例: 電源オプション インターネットオプション)

該当する項目を入力画面から実行すると、対応するコントロールパネル項目を開くことができる。

※ あとからインストールしたプログラムによって追加される項目は表示できない場合がある
(例: ハードウェアベンダのユーティリティやJavaのコントロールパネルなど)

スタートメニューに登録された項目

スタートメニューに登録されたプログラムを候補として表示し、実行することができる。

最近使ったファイル

システムの最近使ったファイルに登録されたファイル名を候補として表示する。実行すると、ファイルを開くことができる。 (拡張子に関連付けたアプリケーションで開く)

例:

UWPアプリ

システムにインストールされたUWPを候補として表示し、実行することができる。

例: 映画アプリ

MMCスナップイン

MMC(Microsoft管理コンソール)の要素を候補として表示し、実行することができる。
入力欄にMMCスナップインのアプリケーションタイトルを入力すると、該当するMMCスナップインを実行することができる。

例: ディスクの管理

Windowsの設定

Windowsの設定アプリの各ページ要素を候補として表示し、実行することができる。

例: Windows Updateを表示する


↓

おことわり

クリップボード履歴

クリップボードに保存されたテキストの履歴を候補として表示する機能。
候補を選択すると、それをクリップボードに再コピーしたり、コピペしたりなどすることができる。

プレフィックスとなる文字列を入力すると、クリップボードに保存されたテキストが候補として表示される。 (上記の例だと、cbがプレフィックス)

各種設定はアプリ設定から設定することができる。

デフォルトでこの機能は無効化されており、利用するには、アプリ設定から有効化する必要がある。

git-bashパス変換

入力欄にgit-bash上のパス表記でファイルパスを入力すると、対応するWindowsローカルパスに変換するコマンドを表示する

コマンドを実行すると、Windowsローカルパスをクリップボードにコピーする

また、入力欄にWindowsローカルパス表記でファイルパスを入力すると、対応するgit-bash上のパス表記に変換するコマンドを表示する

fileプロトコルをローカルパスに変換

file://...で始まるパスをローカルパスやUNC形式のパスに変換し、変換したパスに対して下記の操作を行うことができる。

実行時の動作
押下キー 動作
Enter 変換後のパスをクリップボードにコピー
Shift-Enter 開く(ファイルを実行する)
Ctrl-Enter パスを開く(パスが存在するフォルダをファイラーで開く)
fileプロトコルの例

file:///C:/Windows/WindowsUpdate.log → C:\Windows\WindowsUpdate.log

その他の機能

ログ出力レベル

ログファイルに出力するメッセージのレベルを選択する。

ログファイルは設定ファイルの保存先フォルダ内に<アプリ名>.logというファイル名で出力する。
アプリケーション設定のその他で出力対象とするログレベルを設定することができる。

【試作】連続稼働を警告する

休憩を挟まずに連続して作業を続けていた場合に、その旨をトースト通知する機能。
休憩を促す目的。
スクリーンロックを休憩(離席)とみなす。

アプリケーション設定のその他で有効化することにより利用できる。

マクロ機能

コマンドのパラメータとしてマクロを使用することができる。
マクロを使うと、クリップボード/時刻/環境変数の値など、その時々や環境に応じて変化する動的な値に置き換えることができる。
マクロは${macroName arg1 arg2 ...} のような書式で指定する。
引数がないマクロの場合は$macroNameという書式も可能

マクロの一覧

app

アプリケーション名やアプリケーションのバージョン、ビルド日時を得る

記法

以下のいずれかを指定できる。

例
# アプリ名を得る
${app}   → Soyokaze
${app name}   → Soyokaze
# バージョン番号を得る
${app version}   → 0.30.0
# ビルド日を得る
${app builddate}   → 2024/11/08
# ビルド時刻を得る
${app builddate}   → 01:23:45

basename

引数で与えたパスからファイル名を除去する

記法

${basename パス文字列}の形式で指定する。

例
# ディレクトリパスを得る
${basename c:\dir\a.txt }   → c:\dir

clipboard

クリップボードに入っている値に置き換えることができる。

記法

${clipboard}の形式で指定する。

date

現在の日付・時刻に置き換えることができる。

日付・時刻に置き換える際の書式を指定したり、現在時刻に対して任意のオフセット(時間差分)を指定できる。

記法

${date [format [offset]]}の形式で指定する。

formatで日付の書式を指定できる。

書式を指定しない場合は、時分秒(%H:%M:%S)を表示する

offsetでオフセットを指定する。

オフセットを指定しない場合は現在時刻を表示する。

日付の書式

strftimeの書式をそのまま指定する。

コード 意味 例
%a ロケールでの曜日 火
%A ロケールでの曜日(完全) 火曜日
%b ロケールでの月 11
%B ロケールでの月(完全) 11月
%c ロケールでの日付と時刻 2024/11/19 12:34:45
%C 西暦上二桁 20
%d 月の日付(1-31) 19
%D %m/%d/%y 11/19/24
%e 月の日付、右寄せ二桁 9
%e 月の日付、右寄せ二桁 9
%F %Y-%m-%d 2024-11-19
%g 西暦の年の下二桁 24
%G 西暦の年 2024
%h %bと同じ 11
%H 24 時間形式の時(00-23) 14
%I 12 時間形式の時(01-12) 2
%j 年の通算日 (001 - 366) 324
%m 月 (01 - 12) 11
%M 分 (00 - 59) 25
%n 改行文字 -
%p ロケールでの午前/午後表記 午前
%r ロケールでのAM/PM形式の時刻 xxx
%R %H:%Mと同じ 14:09
%S 秒(00 - 59) 48
%t タブ文字 -
%T %H:%M:%Sと同じ 14:10:59
%u 曜日を表す数値(1 - 7、月曜日が 1) 2
%U 年の週数(0-53)。週の初日は日曜 46
%V 年の週数(1-53)。週の初日は日曜 46
%w 曜日を表す数値(0 - 6、日曜日が 0) 2
%W 年の週数(00-53)、週の初日は月曜 46
%x ロケールでの日付表現 2024/11/19
%X ロケールでの時刻表現 14:43:56
%y 西暦下二桁(00 - 99) 24
%Y 西暦四桁(00 - 99) 2024
%z 時差。UTCからのオフセット +0900
%Z ロケールでのタイム ゾーン名称 東京(標準時)
%% パーセント記号 %
オフセット

以下の形式で指定する。

[S](+ or -)(オフセット値)(Y or M or D or h or m or s)
例
# マクロ実行日時が 2024/11/18(月) 12:34:45 だったとする

${date}
  → 12:34:45

${date "%Y/%m/%d" +1D}
  → 2024/11/19 (翌日の年月日)

${date "%Y/%m/%d" S+1D}
  → 2024/11/18 (日曜日11/17の1日後の年月日)
制限

env

環境変数の値に置き換えることができる。

記法

${env 環境変数名}の形式で指定する。

例
# ユーザーのホームディレクトリのパスを取得する
${env USERPROFILE}
 → C:\Users\username

# ユーザー名を取得する
${env USERNAME}
 → username

random

乱数を生成する系の処理を行うためのマクロ。
現在はuuidの生成のみをサポートする。

記法

${random 種類}の形式で指定する。

例
# UUIDを生成する
${random uuid}
  → 36128e01-947e-4bd2-864c-16a234c32a8d

afxw

外部ファイラとしてあふwを利用している場合に、あふw側で表示しているカレントディレクトリを取得することができる。
このマクロを使う場合、あふ側の設定でオートメーションサーバ登録しておく必要がある。

記法

${afxw currentdir}と記述する。

powerstatus

【試作】
電源状態に関する情報を取得し表示することができる。

記法

${powerstatus format}の形式で記述する。

format部分に表示する情報を表す指定子のいずれかを記述する。

指定子 意味
%l バッテリー残量を表すパーセント(0-100%)、バッテリー駆動でない場合は(不明)
%a AC電源に接続されているかの状態 オンライン、オフライン、不明のいずれか

候補欄のコマンド表示順序について

候補欄のコマンド表示順序をコマンドの一致度と優先度に基づき決定している。
入力キーワードと各コマンド名を比較し、どのように一致するかをみる。

一致度が高いものを優先して表示する。
一致度が同じ場合はコマンドの優先度に従う。

スペース区切りで複数キーワード指定された場合、個々のキーワードごとに候補の名前と部分一致比較を行い、すべてマッチするものを対象とする

一致度の区分

一致の度合いに応じて、候補欄での表示順序を変えている。一致度の区分として以下の4種類を設けている。 先に挙げたほうが優先順位が高い(先に表示する)

完全一致

キーワードのいずれかが、候補と完全一致する

前方一致

先頭のキーワードと候補が前方一致する

部分一致

与えられたキーワードが候補に部分的に一致する

弱一致

他の区分の候補がない場合に表示対象とする、特殊な区分
Web検索コマンドや簡易辞書コマンドなどにおいて、コマンド名がなくても候補として表示するものを弱一致としている。

設定ファイルの保存先

アプリ初回起動時に ユーザーフォルダ直下(通常は C:\Users\<ユーザー名>)に.soyokazeフォルダを作成し、このフォルダ内に設定ファイル一式を保存する。

ポータブル版

exeと同じフォルダ階層にprofileというフォルダが存在する場合、ポータブル版として動作する。
この場合、設定ファイル一式をprofileフォルダ内に作成する。

コマンドラインオプション

なお、上記のコマンドラインオプションによる実行は、事前に本アプリが起動している状態で行う必要がある
(起動していない状態で実行した場合、単にアプリが起動するだけ)

取り扱い種別、ライセンス

フリーソフト

ソースコード

https://github.com/ampmmn/Soyokaze

利用ライブラリ

免責事項

連絡先

htmnymgw@gmail.com