Skip to content

Configuration

Jump to bottom
LinJHS edited this page Jan 4, 2026 · 3 revisions

Configuration

Initial Setup

When you launch Win Folder Manager for the first time, you will be prompted to set the Root Path.

  • Root Path: This is the top-level directory that contains the folders you want to manage.
    • Example: D:\Games, E:\Projects, Z:\Shared
    • The application scans the immediate subdirectories of this root path.

Configuration File

The configuration is stored in a JSON file located in your user's AppData directory. This ensures your settings persist across updates.

  • Location: %APPDATA%\win-folder-manager\config.json
    • Usually: C:\Users\<YourUsername>\AppData\Roaming\win-folder-manager\config.json

Config Structure

{
    "root_path": "D:\\MyFolders",
    "icons": [
        {
            "name": "Game Icon",
            "path": "D:\\Resources\\Icons\\game.ico"
        }
    ]
}

Icon Library Management

In the Settings (Global Config) modal, you can manage your Icon Library.

  • Purpose: Instead of finding the icon path every time, you can save frequently used icons with a friendly name.
  • How to use:
    1. Click "Settings" in the top right.
    2. Under "Icon Library Management", click "+ Add New Icon".
    3. Select File: A file dialog will appear.
      • Select .ico: The path is added directly.
      • Select Image (png/jpg/etc): The image is automatically converted to .ico and saved to your configured cache directory.
    4. Enter a Name (e.g., "Work", "Game", "Movie") if needed.
    5. Save Config.
    6. Now, when editing a folder, you can select these icons from a dropdown menu!

Icon Cache Mode

Configure where generated icons (from AI or Image Conversion) are stored.

  • Global (Default): Icons are saved in a central directory (e.g., %APPDATA%\win-folder-manager\icons). Useful for sharing icons across different root folders.
  • Root Relative: Icons are saved in a hidden folder (e.g., .emoji_cache) inside your current Root Path. Useful for portability (e.g., on a USB drive).

AI Configuration

Enable AI features to automatically generate folder aliases and icons.

  1. Enable AI: Toggle the "AI Auto-naming Configuration" switch in Settings.
  2. Provider: Select your preferred AI provider (e.g., OpenAI, DeepSeek, SiliconFlow). You can add custom providers.
  3. API Key & Model: Enter your API Key and select the model you wish to use.

Emoji Cache Mode

When AI generates an emoji icon, it needs to save the .ico file somewhere.

  • Global (Default): Saves all generated icons in a single, central directory. Useful if you want to keep your project folders clean.
  • Root Relative: Saves icons in a hidden .emoji_cache folder inside your current workspace root. Useful if you want the icons to travel with the project (e.g., on a USB drive).

Clone this wiki locally