nvimのダッシュボードでオタ活してみた(alpha.nvim × アスキーアート)
はじめに
Neovim起動時に毎回目にするダッシュボード。せっかくなら自分好みにカスタマイズしたいですよね。
自分は最近卒業してしまった推しのシンボルをアスキーアートにして表示するようにしてみました。
この記事では、alpha.nvimのダッシュボードに好きな画像をアスキーアートとして表示する手順を参考にした記事も添えて解説します。

前提条件
- Neovimがインストールされていること
- alpha.nvimプラグインの基本的な使い方を知っていること
- Lazy.nvimなどのプラグインマネージャーを使用していること
アスキーアートを作る
ほとんどこちらの記事だけを参考にして作成しました。
Startify系プラグインのお供に、Ascii Art Generator
ただし、上記の方法だけでは「Neovim」のタイトルテキストとイラストを1つのアスキーアートとして統合することが難しかったため、スマホのibisPaintXを使って先にタイトルとイラストを合体させた画像を作成し、それをアスキーアート化してくれるサイト「Image to Dot Art Generater」でアスキーアートにしました。
ibisPaintXの様子

Image to Dot Art Generaterで生成後の様子

以下は、最終的に採用した設定値です。これらの値は試行錯誤の結果なので、使用する画像に応じて調整してください。
| 項目 | 値 |
|---|---|
| ibisPaintXで作成した画像サイズ | 1000×450(横:2000px,縦:900px) |
Image to Dot Art Generaterのhigher-resolution値 |
75 |
| アスキーアート後のサイズ | threshold=0.50, width=98, characters=2036 |
⚠️ 注意
ibisPaintXで画像を保存する際、透過する設定をONにしてしまうとこのように不恰好な縁ができてしまうので、透過OFFで保存することを推奨します

アスキーアートを改善する
Image to Dot Art Generaterで完成したアスキーアートをいざalpha.nvimで表示しても、出来上がったものは穴ボコだらけの不恰好なものでした。

これはこれで味があっていいのかもしれませんが、自分好みではないので穴を埋めたい。
しかし、私は点字が読めないので、ちょうど穴を埋めてくれる点字がどれなのか調べることができません...
点字テキスト検索フォームの使い方
そこで、点字の形で検索してくれるサイト「点字テキスト検索フォーム」(筆者作成)を作りました。
使い方は以下の通りです:
- 点字テキスト検索フォームにアクセス
- 埋めたい「穴」の形に合わせて、検索フォームで点字パターンを選択
- 例: 左上と右下が埋まっている場合は、該当する箇所をクリック
- マッチする点字をクリックするとクリップボードにコピーされる
- エディタでアスキーアートの該当箇所にペースト

完成したものとの比較

alpha.nvimのコードを書く
ファイルの配置
作成したアスキーアートをAA-dashboard.txtという名前で保存します。
ファイルの配置場所は ~/.config/nvim/AA-dashboard.txt です(Linuxの場合)。
依存プラグイン
このコードは以下のプラグインに依存しています:
-
goolord/alpha-nvim: ダッシュボード本体 -
echasnovski/mini.icons: アイコン表示 -
fffプラグイン: ファイル検索 -
Snacks: 最近開いたファイルとgrep検索 -
MiniFiles: ファイルブラウザ
設定コード
config内の.txt専用ファイルへ保存して、呼び出す処理を用意したらOKです。
また、元々はLazyVimユーザーで、LazyVimのダッシュボードに近いUIにしたかったため、キーマップガイドも作っています。
今回は参考になりそうな記事が見当たらなかったため、alpha.nvimのgithubリポジトリを参考にしました。
また、ガイドで表示する記号はNerdFontシンボルでそれっぽいものを探しました。
細かいところはAIエージェントくんに丸投げで完成させました。
{
"goolord/alpha-nvim",
dependencies = { "echasnovski/mini.icons" },
config = function()
local alpha = require("alpha")
local dashboard = require("alpha.themes.dashboard")
-- ASCIIアートファイルのパスを構築
-- vim.fn.stdpath("config")はNeovimの設定ディレクトリを返す(例: ~/.config/nvim)
local ascii_art_path = vim.fn.stdpath("config") .. "/AA-dashboard.txt"
if vim.fn.filereadable(ascii_art_path) == 1 then
dashboard.section.header.val = vim.fn.readfile(ascii_art_path)
else
-- フォールバック用のシンプルなロゴ
dashboard.section.header.val = {
" ",
" ███╗ ██╗███████╗ ██████╗ ██╗ ██╗██╗███╗ ███╗ ",
" ████╗ ██║██╔════╝██╔═══██╗██║ ██║██║████╗ ████║ ",
" ██╔██╗ ██║█████╗ ██║ ██║██║ ██║██║██╔████╔██║ ",
" ██║╚██╗██║██╔══╝ ██║ ██║╚██╗ ██╔╝██║██║╚██╔╝██║ ",
" ██║ ╚████║███████╗╚██████╔╝ ╚████╔╝ ██║██║ ╚═╝ ██║ ",
" ╚═╝ ╚═══╝╚══════╝ ╚═════╝ ╚═══╝ ╚═╝╚═╝ ╚═╝ ",
" ",
}
end
-- ボタン設定(Nerd Fonts)
dashboard.section.buttons.val = {
dashboard.button("f", " Find file", ":lua require('fff').find_files()<CR>"),
dashboard.button("n", " New file", ":ene <BAR> startinsert <CR>"),
dashboard.button("r", " Recent files", ":lua Snacks.picker.recent()<CR>"),
dashboard.button("g", " Find text", ":lua Snacks.picker.grep()<CR>"),
dashboard.button("u", " Update plugins", ":Lazy sync <CR>"),
dashboard.button("q", " Quit", ":qa<CR>"),
}
-- フッター設定
local function footer()
local total_plugins = require("lazy").stats().count
local datetime = os.date(" %Y-%m-%d %H:%M:%S")
local version = vim.version()
local nvim_version_info = " v" .. version.major .. "." .. version.minor .. "." .. version.patch
return datetime .. " " .. total_plugins .. " plugins" .. nvim_version_info
end
dashboard.section.footer.val = footer()
-- レイアウト調整
dashboard.section.header.opts.hl = "Type" -- ヘッダーの配色
dashboard.section.buttons.opts.hl = "Keyword" -- ボタンの配色
dashboard.section.footer.opts.hl = "Comment" -- フッターの配色
-- 余白調整(数値はスペース行数)
dashboard.config.layout = {
{ type = "padding", val = 2 }, -- ヘッダー上の余白
dashboard.section.header,
{ type = "padding", val = 2 }, -- ヘッダーとボタン間の余白
dashboard.section.buttons,
{ type = "padding", val = 1 }, -- ボタンとフッター間の余白
dashboard.section.footer,
}
alpha.setup(dashboard.config)
end,
},
よくあるトラブルシューティング
アスキーアートが表示されない
- ファイルパスが正しいか確認:
:echo stdpath("config")で設定ディレクトリを確認 - ファイルの文字コードがUTF-8になっているか確認
表示が崩れる
- 使用しているフォントが点字文字に対応しているか確認
- フォントサイズやターミナルの幅を調整
おまけ(mini.clueを有効にしたい)
こちらもLazyVimから輸入してきたものですが、普段キーマップのヘルプウィンドウにmini.clueを使用しています。
ですが、alpha.nvimで表示するダッシュボードは通常のバッファーとは違うファイル形式らしく、そのままだとヘルプウィンドウが表示できません。

なので、alpha.nvimのconfig内でmini.clueを有効にする処理も追加しています。
-- alphaバッファでmini.clueのトリガーを有効化
vim.api.nvim_create_autocmd('FileType', {
pattern = 'alpha',
callback = function()
vim.schedule(function()
require('mini.clue').ensure_buf_triggers()
end)
end
})
このコードの動作:
-
FileTypeイベントでalphaバッファが開かれたことを検知 -
vim.scheduleで次のイベントループで処理を実行(タイミング調整) -
mini.clue.ensure_buf_triggers()でそのバッファのキーマップトリガーを有効化
これにより、alpha.nvimのダッシュボード上でもmini.clueのヘルプウィンドウが表示できるようになります。
完成
このようにしてalpha.nvimを使った推し活ダッシュボードが完成しました。
(githubリポジトリのURL)

元々画像のアスキーアート化は微調整が難しく、満足のいくクオリティを作成することは難しかったと思うのですが、「点字テキスト検索フォーム」のおかげでその辺りが大分改善されていたら幸いです。
もしこちらのサイトの改善要望などもあればぜひお気軽にXアカウントにてお声掛け下さい🙇
Discussion