Linux Mint 22 での Cursor インストールからメニュートラブル解決まで

以下は、Linux Mint 22 に Cursor をインストールし、アプリケーションメニューの重複エントリー問題を解決した完全なコマンドライン記録です。

1. Cursor の初期インストール
2. デスクトップエントリの作成
3. アイコンファイルの配置
4. トラブル発見：重複エントリの問題
1. 4.1. 問題の調査
2. 4.2. 問題ファイルの内容確認
5. 重複エントリの解決
6. 追加トラブル：検索結果にアイコンファイルが表示
7. 最終確認
8. 解決結果
トラブルシューティングのポイント

1. Cursor の初期インストール

# Cursorの公式リリースページから最新版をダウンロード
# https://cursor.sh/ からLinux版のダウンロードリンクを取得

# ダウンロードしたAppImageを実行可能にする
chmod +x cursor-*.AppImage

# ~/.local/bin にインストール（PATH が通っている場所）
mkdir -p ~/.local/bin
mv cursor-*.AppImage ~/.local/bin/cursor

# 実行権限を確認
ls -la ~/.local/bin/cursor

2. デスクトップエントリの作成

# アプリケーションエントリ用ディレクトリを作成
mkdir -p ~/.local/share/applications

# デスクトップエントリファイルを作成
cat > ~/.local/share/applications/cursor.desktop << EOF
[Desktop Entry]
Name=Cursor
Comment=AI-powered code editor
Exec=$HOME/.local/bin/cursor %U
Icon=$HOME/.local/share/icons/cursor.png
Terminal=false
Type=Application
Categories=Development;TextEditor;Utility;
StartupWMClass=Cursor
MimeType=text/plain;inode/directory;
EOF

3. アイコンファイルの配置

# アイコン用ディレクトリを作成
mkdir -p ~/.local/share/icons

# Cursorからアイコンを抽出（または公式サイトからダウンロード）
# この例では、既存のアイコンファイル cursor.png があると仮定
cp cursor.png ~/.local/share/icons/cursor.png

4. トラブル発見：重複エントリの問題

症状: アプリケーションメニューの Programming セクションに「Cursor」と「Cursor.Appimage」の2つのエントリが表示される

4.1. 問題の調査

# Cursorに関連するデスクトップファイルをすべて検索
find /usr/share/applications ~/.local/share/applications -name "*.desktop" -exec grep -l -i "cursor\|appimage" {} \; 2>/dev/null

# 結果:
# /usr/share/applications/gimp.desktop
# /home/ten/.local/share/applications/cursol.desktop  ← 問題のファイル
# /home/ten/.local/share/applications/cursor.desktop

4.2. 問題ファイルの内容確認

# 問題のファイル内容を確認
cat ~/.local/share/applications/cursol.desktop
# [Desktop Entry]
# Name=Cursor
# Exec=/opt/cursor.appimage  ← 古いパスを参照
# Icon=/opt/cursor.png
# Type=Application
# Categories=Development;

# 正しいファイル内容を確認
cat ~/.local/share/applications/cursor.desktop
# [Desktop Entry]
# Name=Cursor
# Comment=AI-powered code editor
# Exec=/home/ten/.local/bin/cursor %U
# Icon=/home/ten/.local/share/icons/cursor.png
# Terminal=false
# Type=Application
# Categories=Development;TextEditor;Utility;
# StartupWMClass=Cursor
# MimeType=text/plain;inode/directory;

5. 重複エントリの解決

5.1. 古いデスクトップエントリを削除

# 問題のファイルを削除
rm ~/.local/share/applications/cursol.desktop

5.2. 古いCursorファイルの確認と削除

# 古いファイルが残っていないか確認
ls -la /opt/cursor.appimage 2>/dev/null || echo "/opt/cursor.appimage は存在しません"
ls -la /opt/cursor.png 2>/dev/null || echo "/opt/cursor.png は存在しません"

# 古いファイルが存在した場合は削除
sudo rm /opt/cursor.appimage
sudo rm /opt/cursor.png

# 削除確認
ls -la /opt/cursor* 2>/dev/null || echo "古いCursorファイルは完全に削除されました"

5.3. メニューデータベースの更新

# デスクトップデータベースを更新
update-desktop-database ~/.local/share/applications/

# キャッシュをクリア
rm -rf ~/.cache/menus/
rm -rf ~/.cache/cinnamon/

6. 追加トラブル：検索結果にアイコンファイルが表示

症状: アプリケーション検索で「cursor.png」が検索結果に表示される

6.1. アイコンファイルを標準ディレクトリに移動

# 標準的なアイコンディレクトリを作成
mkdir -p ~/.local/share/icons/hicolor/48x48/apps/

# アイコンファイルを標準的な場所に移動
mv ~/.local/share/icons/cursor.png ~/.local/share/icons/hicolor/48x48/apps/cursor.png

6.2. デスクトップエントリの更新

# アイコンパスをシンプルな名前に変更
cat > ~/.local/share/applications/cursor.desktop << EOF
[Desktop Entry]
Name=Cursor
Comment=AI-powered code editor
Exec=$HOME/.local/bin/cursor %U
Icon=cursor
Terminal=false
Type=Application
Categories=Development;TextEditor;Utility;
StartupWMClass=Cursor
MimeType=text/plain;inode/directory;
EOF

6.3. システムキャッシュの完全クリア

# 検索関連キャッシュを全てクリア
rm -rf ~/.cache/menus/
rm -rf ~/.cache/applications/
rm -rf ~/.cache/desktop-directories/
rm -rf ~/.cache/cinnamon/
rm -rf ~/.cache/thumbnails/
rm -rf ~/.cache/zeitgeist/
rm -rf ~/.cache/tracker/
rm -rf ~/.cache/gnome-software/
rm -rf ~/.local/share/recently-used.xbel

# システムデータベースを更新
update-desktop-database ~/.local/share/applications/
gtk-update-icon-cache -f ~/.local/share/icons/hicolor/ 2>/dev/null || true

7. 最終確認

# Cursorの実行ファイル確認
which cursor
# /home/ten/.local/bin/cursor

# Cursorの起動テスト
cursor --version 2>/dev/null || cursor &

# デスクトップエントリの確認
find ~/.local/share/applications -name "*curso*"
# /home/ten/.local/share/applications/cursor.desktop

# アイコンファイルの確認
ls -la ~/.local/share/icons/hicolor/48x48/apps/cursor.png
# -rw-rw-r-- 1 ten ten 1507 6月 17 07:40 /home/ten/.local/share/icons/hicolor/48x48/apps/cursor.png

8. 解決結果

✅ 成功:

アプリケーションメニューの Programming セクションに Cursor が1つだけ表示される
アイコン付きで正常に表示される
検索結果に不要なファイルが表示されない
Cursor が正常に起動する

トラブルシューティングのポイント

重複エントリの原因: 古いインストール時のデスクトップファイルが残っていた
検索結果汚染の原因: アイコンファイルが検索対象ディレクトリに配置されていた
解決の鍵:
- 全ての関連ファイルを徹底的に検索
- 標準的なLinuxディレクトリ構造に従った配置
- キャッシュの完全クリア

このプロセスは、Linux での AppImage アプリケーション管理の良い学習例となります。