✨

nvimのダッシュボードでオタ活してみた(alpha.nvim × アスキーアート)

に公開
2026/01/08

はじめに

Neovim起動時に毎回目にするダッシュボード。せっかくなら自分好みにカスタマイズしたいですよね。
自分は最近卒業してしまった推しのシンボルをアスキーアートにして表示するようにしてみました。

この記事では、alpha.nvimのダッシュボードに好きな画像をアスキーアートとして表示する手順を参考にした記事も添えて解説します。

執筆者が泣きながら作ったneovimダッシュボード(with天音かなた)

前提条件

  • Neovimがインストールされていること
  • alpha.nvimプラグインの基本的な使い方を知っていること
  • Lazy.nvimなどのプラグインマネージャーを使用していること

アスキーアートを作る

ほとんどこちらの記事だけを参考にして作成しました。
Startify系プラグインのお供に、Ascii Art Generator

ただし、上記の方法だけでは「Neovim」のタイトルテキストとイラストを1つのアスキーアートとして統合することが難しかったため、スマホのibisPaintXを使って先にタイトルとイラストを合体させた画像を作成し、それをアスキーアート化してくれるサイト「Image to Dot Art Generater」でアスキーアートにしました。

ibisPaintXの様子
ibisPaintXの様子のスクリーンショット

Image to Dot Art Generaterで生成後の様子
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で表示しても、出来上がったものは穴ボコだらけの不恰好なものでした。

生成したアスキーアートを使ったneovimのダッシュボードのスクリーンショット

これはこれで味があっていいのかもしれませんが、自分好みではないので穴を埋めたい。

しかし、私は点字が読めないので、ちょうど穴を埋めてくれる点字がどれなのか調べることができません...

点字テキスト検索フォームの使い方

そこで、点字の形で検索してくれるサイト「点字テキスト検索フォーム」(筆者作成)を作りました。

使い方は以下の通りです:

  1. 点字テキスト検索フォームにアクセス
  2. 埋めたい「穴」の形に合わせて、検索フォームで点字パターンを選択
    • 例: 左上と右下が埋まっている場合は、該当する箇所をクリック
  3. マッチする点字をクリックするとクリップボードにコピーされる
  4. エディタでアスキーアートの該当箇所にペースト

点字テキスト検索フォームのスクリーンショット
完成したものとの比較
アスキーアートのbefer afterの比較画像

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で表示するダッシュボードは通常のバッファーとは違うファイル形式らしく、そのままだとヘルプウィンドウが表示できません。

mini.clueを使ったヘルプウィンドウのスクリーンショット

なので、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
})

このコードの動作:

  1. FileTypeイベントでalphaバッファが開かれたことを検知
  2. vim.scheduleで次のイベントループで処理を実行(タイミング調整)
  3. mini.clue.ensure_buf_triggers()でそのバッファのキーマップトリガーを有効化

これにより、alpha.nvimのダッシュボード上でもmini.clueのヘルプウィンドウが表示できるようになります。

完成

このようにしてalpha.nvimを使った推し活ダッシュボードが完成しました。
(githubリポジトリのURL)

執筆者が泣きながら作ったneovimダッシュボード(with天音かなた)

元々画像のアスキーアート化は微調整が難しく、満足のいくクオリティを作成することは難しかったと思うのですが、「点字テキスト検索フォーム」のおかげでその辺りが大分改善されていたら幸いです。

もしこちらのサイトの改善要望などもあればぜひお気軽にXアカウントにてお声掛け下さい🙇

Discussion