Windowsのエクスプローラー上のフォルダアイコンのサムネイルの変更方法(できればPythonで)

Question

前提

Windowsのエクスプローラーで表示されるフォルダ内のサムネイルを、Pythonを使って変更したいのですが、方法が分からないため教えていただきたいです。
(Windowsのエクスプローラーで、特大アイコン表示をすると以下のようにフォルダ内の画像がサムネイルとして表示されますが、画像が複数枚ある時にはランダムで画像が選択されるため、Pythonを使ってこの画像を指定したいです。)

フォルダのプロパティからも手動で画像を指定できるのですが、指定したいフォルダの数が大量にあり、機械的に処理したいと思っています。
Python指定なのは私がPythonしか使えないためです。
ただ、他の言語等で解決策がある場合、そちらでもよいので教えていただけると幸いです。

調べたことなど

以下の、SHFOLDERCUSTOMSETTINGS構造体に含まれるpszLogoが、フォルダのサムネイル画像を指しているのだと思い、これを変更しようと試みました。
https://learn.microsoft.com/en-us/windows/win32/api/shlobj_core/ns-shlobj_core-shfoldercustomsettings

以下のコードを参考にして、pszLogoを書き換えるようなコードを書いて実行してみましたが、サムネイルは変化しませんでした。
https://stackoverflow.com/questions/4662759/how-to-change-folder-icons-with-python-on-windows
(上記コードはサムネイルではなくアイコン自体を書き換える処理です。一応、上記を実行するとアイコンの書き換えはできました)

実行したソースコード

import os
import ctypes
from ctypes import POINTER, Structure, c_wchar, c_int, sizeof, byref
from ctypes.wintypes import BYTE, WORD, DWORD, LPWSTR, LPSTR
import win32api    

HICON = c_int
LPTSTR = LPWSTR
TCHAR = c_wchar
MAX_PATH = 260
FCS_READ = 0x00000001
FCSM_LOGO = 0x00000020
FCSM_ICONFILE = 0x00000010
FCS_FORCEWRITE = 0x00000002
SHGFI_ICONLOCATION = 0x000001000    

class GUID(Structure):
    _fields_ = [
        ('Data1', DWORD),
        ('Data2', WORD),
        ('Data3', WORD),
        ('Data4', BYTE * 8)]

class SHFOLDERCUSTOMSETTINGS(Structure):
    _fields_ = [
        ('dwSize', DWORD),
        ('dwMask', DWORD),
        ('pvid', POINTER(GUID)),
        ('pszWebViewTemplate', LPTSTR),
        ('cchWebViewTemplate', DWORD),
        ('pszWebViewTemplateVersion', LPTSTR),
        ('pszInfoTip', LPTSTR),
        ('cchInfoTip', DWORD),
        ('pclsid', POINTER(GUID)),
        ('dwFlags', DWORD),
        ('pszIconFile', LPTSTR),
        ('cchIconFile', DWORD),
        ('iIconIndex', c_int),
        ('pszLogo', LPTSTR),
        ('cchLogo', DWORD)]

class SHFILEINFO(Structure):
    _fields_ = [
        ('hIcon', HICON),
        ('iIcon', c_int),
        ('dwAttributes', DWORD),
        ('szDisplayName', TCHAR * MAX_PATH),
        ('szTypeName', TCHAR * 80)]    

def setthumbnail(folderpath, thumbnailpath):

    shell32 = ctypes.windll.shell32

    folderpath = str(os.path.abspath(folderpath))
    thumbnailpath = str(os.path.abspath(thumbnailpath))

    fcs = SHFOLDERCUSTOMSETTINGS()
    fcs.dwSize = sizeof(fcs)
    fcs.dwMask = FCSM_LOGO
    fcs.pszLogo = thumbnailpath
    fcs.cchLogo = 0

    hr = shell32.SHGetSetFolderCustomSettings(byref(fcs), folderpath,
                                              FCS_FORCEWRITE)

    if hr:
        raise WindowsError(win32api.FormatMessage(hr))

    sfi = SHFILEINFO()
    hr = shell32.SHGetFileInfoW(folderpath, 0, byref(sfi), sizeof(sfi),
                                SHGFI_ICONLOCATION)
    if hr == 0:
        raise WindowsError(win32api.FormatMessage(hr))

    index = shell32.Shell_GetCachedImageIndexW(sfi.szDisplayName, sfi.iIcon, 0)
    if index == -1:
        raise WindowsError()

    shell32.SHUpdateImageW(sfi.szDisplayName, sfi.iIcon, 0, index)

setthumbnail({対象フォルダのパス}, {.pngのパス})

setthumbnailで、icoファイルはbmpファイルを指定しても変化はありませんでした。

どなたかわかる方がいらっしゃいましたらご教示お願い致します。

Answer 1

私の環境では win10/python3.10 で、WindowsError が出ますが、設定自体は正常に変更できました。
（追記: SHGetSetFolderCustomSettings 迄で変更可能だったので、関数内の後半は不要です）

隠しファイルを表示する設定にして、対象フォルダ内のdesktop.ini ファイルの中身を確認してみてください。

Desktop.iniを使用してフォルダーをカスタマイズする方法

• PathMakeSystemFolder (attrib +s FolderName コマンド) で
  対象フォルダをシステムフォルダに変更 (desktop.ini によるカスタマイズを有効にする）
• desktop.ini を配置
• エクスプローラー(explorer.exe) を再起動。キャッシュが影響しないように 設定変更を反映させるため再読込。

　追記: SHChangeNotify により設定変更を通知

フォルダプロパティのカスタマイズから変更した場合
フォルダー内の desktop.ini の [ViewState] セクション内の Logo に記録されます。
上記のスクリプトを用いた場合は [.ShellClassInfo] セクションの Logo に記録されます。

カスタマイズから変更した場合や、上記のスクリプト(win32 API)で変更した場合は即時反映されますが
desktop.ini ファイルをエディタで直接編集や、プログラムで直接編集した場合は即時反映されないようです。
（訂正: 恐らくキャッシュなどの影響 変更した設定は再読み込みまで反映されない）

追記: 設定の反映方法について、SHChangeNotify により通知できるようです。folderikonより、ctypesを用いた呼び出し例
https://github.com/demberto/FolderIkon/blob/master/folderikon/notify_shell.py

---

尚、できれば Python でとのことですが、ファイルを直接編集するコードの場合は
desktop.ini は 標準ライブラリの configparser モジュールにより扱うことができます。
より簡潔で解りやすいコードにできるはずです。

※ サムネイルではなくアイコンですが、desktop.ini を configparser で操作するコードの参考に。

• windows folder icon changer
• 外部ライブラリで folderikon

---

ctypes でwin32 API を使う方法(質問に掲載のコードの方法) は、
同様のコードを書く場合は C言語で書いたほうが短くかけます。
(ctypes で扱う場合は、構造体館の宣言が必要ですが、C言語では必要なヘッダを読み込むのみ）

C言語と言うと、巨大な開発環境のインストールが必要そうに思われるかもしれませんが、
これくらいの規模のユーティリティーであれば、tcc (Tiny C Compiler) がお勧めです。
C 言語の学習コストがあるかもしれませんが、C言語で行う必要があるのは API 呼び出し部分のみなので
Python でフォルダーの一覧のループ処理をして、path 情報のみを C言語で作ったプログラムへ subprocess.call 等で渡す
といった使い方であれば、学習コストを必要最低限に抑えることができます。

Comments

[shiki980]

反応が遅くなり申し訳ありません。
大変ご丁寧な回答、ありがとうございます。

SHGetSetFolderCustomSettingsはdesktop.iniを作成、編集していたんですね。
色々試した結果私の環境ではなぜか画像のパスに日本語や環境変数が含まれていると変更が反映されないようで、
それらを含まない相対パスを入力にするとスクリプト実行直後にサムネイルを変更することができました(元々絶対パスしか試していませんでした)。
結局Pythonによるiniファイルの修正作業等は不要でしたが、色々と詳しく補足情報も書いていただき、大変ありがとうございました。
また、今後win32 APIを使う機会があった場合、C言語での実装も検討してみたいと思います。