Files

https://files.community/docs/
Admin
Files is a modern file manager for Windows that helps users organize their files and folders with...
Tokens:9,135
Snippets:193
Trust Score:9
Update:5 months ago
Show doc for...
Tokens:
Raw
### Install Files Preview via PowerShell

Source: https://files.community/docs/getting-started/install

Use this command in an administrator PowerShell session to install the preview version of Files.

```powershell
Add-AppxPackage -AppInstallerFile https://cdn.files.community/files/preview/Files.Package.appinstaller
```

--------------------------------

### Install Files Preview via Winget

Source: https://files.community/docs/getting-started/install

Use this command to install the preview version of Files using the Winget package manager.

```bash
winget install -e --id FilesCommunity.FilesPreview
```

--------------------------------

### Install Files Preview via Chocolatey

Source: https://files.community/docs/getting-started/install

Use this command to install the preview version of Files using the Chocolatey package manager.

```bash
choco install filespreview
```

--------------------------------

### Example Placeholder Usage

Source: https://files.community/docs/contributing/translating

Demonstrates how placeholders like {0} and {1} are used in strings to represent dynamic values such as file and folder names.

```plaintext
Are you sure you want to delete {0} from {1}?
```

--------------------------------

### Install Files Stable via Scoop

Source: https://files.community/docs/getting-started/install

Use this command to install the stable version of Files using the Scoop package manager.

```bash
scoop install nonportable/files-np
```

--------------------------------

### Install Files Stable via Winget

Source: https://files.community/docs/getting-started/install

Use this command to install the stable version of Files using the Winget package manager.

```bash
winget install -e --id FilesCommunity.Files
```

--------------------------------

### Install Files Stable via PowerShell

Source: https://files.community/docs/getting-started/install

Use this command in an administrator PowerShell session to install the stable version of Files.

```powershell
Add-AppxPackage -AppInstallerFile https://cdn.files.community/files/stable/Files.Package.appinstaller
```

--------------------------------

### Install .NET Runtime without Administrator Privileges

Source: https://files.community/docs/getting-started/install

Use this PowerShell script to install the .NET 10 runtime for non-administrator installations of Files. Ensure you have downloaded the dotnet-install.ps1 script beforehand.

```powershell
$dotnetDir = "$env:LOCALAPPDATAMicrosoftdotnet"

.dotnet-install.ps1 -Runtime WindowsDesktop -Channel 10.0 -InstallDir $dotnetDir
.dotnet-install.ps1 -Runtime dotnet         -Channel 10.0 -InstallDir $dotnetDir

[System.Environment]::SetEnvironmentVariable("DOTNET_ROOT", $dotnetDir, "User")
```

--------------------------------

### Open Files from Command Line

Source: https://files.community/docs/getting-started/faq

Launch Files from the command line using the appropriate executable for your installed version. Disabling background operation may slow down launch times.

```bash
files-<branch>.exe
```

--------------------------------

### Install Files Stable via Chocolatey

Source: https://files.community/docs/getting-started/install

Use this command to install the stable version of Files using the Chocolatey package manager.

```bash
choco install files
```

--------------------------------

### ICU Pluralization Example

Source: https://files.community/docs/contributing/translating

Illustrates the use of ICU message syntax for handling pluralization, showing different plural categories like 'one', 'few', 'many', and 'other'. The 'other' tag is mandatory.

```plaintext
one (singular)
few (paucal)
many (also used for fractions if they have a separate class)
other (required: general plural form — also used if the language only has a single form)
```

--------------------------------

### ICU Number Formatting Example

Source: https://files.community/docs/contributing/translating

Shows how to use ICU message syntax for number formatting, allowing locale-independent display of percentages, currency, and decimals. The '#' symbol indicates where the number value will be inserted.

```plaintext
{0, number}
```

--------------------------------

### Finder Theme Configuration

Source: https://files.community/docs/customize-settings/appearance

Configure a 'Finder' theme inspired by macOS, setting specific colors for UI elements.

```json
{
  "AppThemeBackgroundColor": "#221d28",
  "AppThemeAddressBarBackgroundColor": "#38343c",
  "AppThemeToolbarBackgroundColor": "#38343c",
  "AppThemeSidebarBackgroundColor": "#464449",
  "AppThemeFileAreaBackgroundColor": "#221d28",
  "AppThemeInfoPaneBackgroundColor": "#38343c"
}
```

--------------------------------

### Locate Files Preview Log (Microsoft Store)

Source: https://files.community/docs/getting-started/faq

Use this path to find the log file for the Microsoft Store version of Files Preview when the UI is inaccessible.

```bash
%LocalAppData%\Packages\49306atecsolution.FilesPreview_et10x9a9vyk8t\LocalState
```

--------------------------------

### Locate Files Preview Log (Sideload)

Source: https://files.community/docs/getting-started/faq

Use this path to find the log file for the sideloaded version of Files Preview when the UI is inaccessible.

```bash
%LocalAppData%\Packages\FilesPreview_1y0xx7n9077q4\LocalState
```

--------------------------------

### Clone the Git Repository

Source: https://files.community/docs/contributing/building-from-source

Use this command to create a local copy of the Files project repository.

```bash
git clone https://github.com/files-community/Files
```

--------------------------------

### Locate Files Stable Log (Sideload)

Source: https://files.community/docs/getting-started/faq

Use this path to find the log file for the sideloaded version of Files Stable when the UI is inaccessible.

```bash
%LocalAppData%\Packages\Files_1y0xx7n9077q4\LocalState
```

--------------------------------

### Set Folder Background Image

Source: https://files.community/docs/features/folder-config

Add this to your desktop.ini file to set a custom background image for a folder. Replace C:\Image.png with the actual path to your image.

```ini
[FilesApp]
Files_BackgroundImage=C:\Image.png
```

--------------------------------

### Locate Files Stable Log (Microsoft Store)

Source: https://files.community/docs/getting-started/faq

Use this path to find the log file for the Microsoft Store version of Files Stable when the UI is inaccessible.

```bash
%LocalAppData%\Packages\49306atecsolution.FilesUWP_et10x9a9vyk8t\LocalState
```

--------------------------------

### Set Folder Background Opacity

Source: https://files.community/docs/features/folder-config

Adjust the opacity of the folder background image. Use values between 0.0 (fully transparent) and 1.0 (fully opaque).

```ini
Files_BackgroundOpacity=0.4
```

--------------------------------

### Open Folder in Files from Command Line

Source: https://files.community/docs/getting-started/faq

Specify a folder path to open it directly within the Files application from the command line.

```bash
files-stable.exe "C:\Users\YourName\Documents"
```

--------------------------------

### Localizing Strings with Extension

Source: https://files.community/docs/contributing/translating

Demonstrates the usage of a custom extension `Strings.ToLocalized` for localizing strings based on ICU message syntax. It shows how to pass parameters for placeholders.

```csharp
"ItemsCount".ToLocalized(itemsCount);
```

```csharp
var localized = "DeleteConfirmation".ToLocalized(fileName, parentFolderName);
```

--------------------------------

### Glass Theme Configuration

Source: https://files.community/docs/customize-settings/appearance

Apply a 'Glass' theme by setting specific background colors for different UI components. This theme pairs well with Acrylic transparency effects.

```json
{
  "AppThemeBackgroundColor": "#00000000",
  "AppThemeAddressBarBackgroundColor": "#00000001",
  "AppThemeToolbarBackgroundColor": "#00000001",
  "AppThemeSidebarBackgroundColor": "#00000001",
  "AppThemeFileAreaBackgroundColor": "#00000001",
  "AppThemeInfoPaneBackgroundColor": "#00000001"
}
```

--------------------------------

### Nord Theme Configuration

Source: https://files.community/docs/customize-settings/appearance

Apply a 'Nord' theme with an Arctic-inspired color scheme, defining colors for various UI components.

```json
{
  "AppThemeBackgroundColor": "#FF1B1F26",
  "AppThemeAddressBarBackgroundColor": "#2E3440",
  "AppThemeToolbarBackgroundColor": "#2E3440",
  "AppThemeSidebarBackgroundColor": "#2E3440",
  "AppThemeFileAreaBackgroundColor": "#2E3440",
  "AppThemeInfoPaneBackgroundColor": "#2E3440"
}
```

--------------------------------

### Set Folder Background Fit

Source: https://files.community/docs/features/folder-config

Control how the background image fits within the folder pane. Values range from 0 (stretch without aspect ratio) to 3 (fill pane, preserve aspect ratio, may crop).

```ini
Files_BackgroundFit=2
```

--------------------------------

### Set Folder Background Horizontal Alignment

Source: https://files.community/docs/features/folder-config

Specify the horizontal alignment of the background image. Values range from 0 (Center) to 3 (Stretch).

```ini
Files_BackgroundHorizontalAlignment=2
```

--------------------------------

### Dracula Theme Configuration

Source: https://files.community/docs/customize-settings/appearance

Set up a 'Dracula' theme, known for its bold and vibrant colors, suitable for dark mode enthusiasts.

```json
{
  "AppThemeBackgroundColor": "#282A36",
  "AppThemeAddressBarBackgroundColor": "#393d4e",
  "AppThemeToolbarBackgroundColor": "#282A36",
  "AppThemeSidebarBackgroundColor": "#393d4e",
  "AppThemeFileAreaBackgroundColor": "#282A36",
  "AppThemeInfoPaneBackgroundColor": "#282A36"
}
```

--------------------------------

### Set Folder Background Vertical Alignment

Source: https://files.community/docs/features/folder-config

Specify the vertical alignment of the background image. Values range from 0 (Top) to 3 (Stretch).

```ini
Files_BackgroundVerticalAlignment=1
```

--------------------------------

### Advanced Background Color Customization

Source: https://files.community/docs/customize-settings/appearance

Modify specific UI areas by directly editing the settings file. Ensure Files is closed before making changes.

```json
{
  "AppThemeBackgroundColor": "#00000000",
  "AppThemeAddressBarBackgroundColor": "#00000000",
  "AppThemeToolbarBackgroundColor": "#00000000",
  "AppThemeSidebarBackgroundColor": "#00000000",
  "AppThemeFileAreaBackgroundColor": "#00000000",
  "AppThemeInfoBackgroundColor": "#00000000"
}
```

--------------------------------

### Custom Font Setting

Source: https://files.community/docs/customize-settings/appearance

Set a custom font family by editing the settings file. This allows for font choices not available in the built-in picker.

```json
{
  "AppThemeFontFamily": "YourFontName"
}
```
Tokens:
Raw