Free, open-source file converter. Convert 263 formats offline by drag & drop — images, PDF, Word, Excel, PowerPoint, HWP/HWPX, video, audio, e-books and archives. No upload, no Office needed.
C# audio-converteravaloniabatch-conversionconvertercsharpdocument-converterdocx-to-pdfdotnetdrag-and-dropfile-conversionfile-converterheic-converterhwphwpximage-converterlinuxmacospdf-convertervideo-converterwindows
// Root settings object persisted to settings.json.
using System.Text.Json;
using System.Text.Json.Serialization;
using Filee.Core.Presets;
namespace Filee.Core.Settings;
public enum ThemeMode
{
System,
Light,
Dark,
}
public enum ThemeStyle
{
Soft,
MaterialYou,
}
/// <summary>What closing the main window does (Settings → General).</summary>
public enum CloseAction
{
/// <summary>Ask, with "Don't ask again" (which saves the answer).</summary>
Ask,
/// <summary>Hide the window; Filee keeps running in the tray.</summary>
Tray,
/// <summary>Quit Filee.</summary>
Quit,
}
/// <summary>Look and feel.</summary>
public sealed class ThemeSettings
{
public ThemeStyle Style { get; set; } = ThemeStyle.Soft;
public ThemeMode Mode { get; set; } = ThemeMode.System;
/// <summary>Accent colour as <c>#RRGGBB</c>.</summary>
public string Accent { get; set; } = "#7F77DD";
/// <summary>Active curated preset key (e.g. "mint", "peach") when a coordinated light/dark pair is used; null for custom choices.</summary>
public string? PresetKey { get; set; }
/// <summary>Base corner radius in pixels. Larger = "softer" UI.</summary>
public double CornerRadius { get; set; } = 16;
/// <summary>
/// Disables animations (for low-end PCs or motion sensitivity).
/// <c>null</c> follows the operating system setting.
/// </summary>
public bool? ReduceMotion { get; set; }
public ThemeSettings Clone() => (ThemeSettings)MemberwiseClone();
}
/// <summary>Geometry and appearance of the donut toolbar.</summary>
public sealed class DonutSettings
{
/// <summary>Outer radius in logical pixels.</summary>
public double OuterRadius { get; set; } = 150;
/// <summary>Inner (hole) radius as a fraction of the outer radius (0.2 - 0.7).</summary>
public double HoleRatio { get; set; } = 0.42;
/// <summary>Background opacity of the slices (<see cref="MinOpacity"/> - 1); labels and outlines stay opaque.</summary>
public double Opacity { get; set; } = 0.96;
/// <summary>The lowest <see cref="Opacity"/> the Theme and Donut toolbar pages offer.</summary>
public const double MinOpacity = 0.1;
/// <summary>The flip key unless the user picks another one (Settings → Shortcuts).</summary>
public const string DefaultFlipKey = "Tab";
/// <summary>
/// The key that flips the open donut to its other face, as a SharpHook key name without "Vc" ("Tab", "F2", "Q");
/// empty for none. See <see cref="EffectiveFlipKey"/>.
/// </summary>
public string FlipKey { get; set; } = DefaultFlipKey;
/// <summary>A turn of the mouse wheel flips the open donut to its other face.</summary>
public bool FlipWithWheel { get; set; } = true;
/// <summary>
/// Keys that never flip the donut: Esc closes it, Enter and Space convert or open a group, the arrows move between
/// slices and Backspace folds a group's ring.
/// </summary>
public static readonly IReadOnlySet<string> ReservedFlipKeys = new HashSet<string>(StringComparer.OrdinalIgnoreCase)
{
"Escape", "Enter", "Space", "Left", "Right", "Up", "Down", "Backspace",
};
/// <summary>
/// Whether <paramref name="key"/> may flip the donut: not a key the donut uses (<see cref="ReservedFlipKeys"/>), nor
/// the key of a keyboard shortcut in <paramref name="gestures"/>. While a drag holds its modifier that shortcut would
/// fire too, and open the donut for the selected files instead.
/// </summary>
public static bool IsFlipKeyAllowed(string key, IEnumerable<TriggerGesture> gestures) =>
!string.IsNullOrWhiteSpace(key) && !ReservedFlipKeys.Contains(key) &&
!gestures.Any(g => g.Kind == TriggerKind.KeyChord && string.Equals(g.Key, key, StringComparison.OrdinalIgnoreCase));
/// <summary>
/// The key that flips the donut now: none when the user cleared it; Tab in place of one that isn't allowed (a file
/// edited by hand, or a keyboard shortcut that took the key since), or none when Tab isn't either.
/// </summary>
public string? EffectiveFlipKey(IEnumerable<TriggerGesture> gestures)
{
if (string.IsNullOrWhiteSpace(FlipKey))
return null;
var list = gestures as IReadOnlyCollection<TriggerGesture> ?? gestures.ToList();
if (IsFlipKeyAllowed(FlipKey.Trim(), list))
return FlipKey.Trim();
return IsFlipKeyAllowed(DefaultFlipKey, list) ? DefaultFlipKey : null;
}
public DonutSettings Clone() => (DonutSettings)MemberwiseClone();
}
/// <summary>All user settings except presets and profiles (which have their own files).</summary>
public sealed class AppSettings
{
/// <summary>Current schema version. Increase when the format changes and add a migration.</summary>
public const int CurrentSchemaVersion = 58;
public int SchemaVersion { get; set; } = CurrentSchemaVersion;
/// <summary><c>"auto"</c>, <c>"en"</c>, <c>"ko"</c> or <c>"zh-CN"</c>.</summary>
public string Language { get; set; } = "auto";
public bool StartWithSystem { get; set; } = true;
/// <summary>Show the Explorer "Convert with Filee" context menu entry.</summary>
public bool ContextMenuEnabled { get; set; } = true;
public bool CheckForUpdates { get; set; } = true;
/// <summary>What closing the main window does. A value from a newer Filee reads as <see cref="CloseAction.Ask"/>.</summary>
[JsonConverter(typeof(LenientEnumJsonConverter<CloseAction>))]
public CloseAction CloseAction { get; set; } = CloseAction.Ask;
/// <summary>Record finished conversions in the history (home page). Off: nothing new is recorded.</summary>
public bool KeepHistory { get; set; } = true;
/// <summary>
/// How many finished conversions the history keeps, newest first (<see cref="MinHistoryLimit"/> to
/// <see cref="MaxHistoryLimit"/>; a value outside is taken as the nearest end). The home page lists the latest
/// ones and searches all of them.
/// </summary>
public int HistoryLimit { get; set; } = 200;
public const int MinHistoryLimit = 50;
public const int MaxHistoryLimit = 2000;
/// <summary><see cref="HistoryLimit"/> within its range.</summary>
[JsonIgnore]
public int EffectiveHistoryLimit => Math.Clamp(HistoryLimit, MinHistoryLimit, MaxHistoryLimit);
/// <summary>Whether the macOS Dock shows Filee.</summary>
[JsonConverter(typeof(IconPreferenceJsonConverter))]
public bool ShowInDock { get; set; } = true;
/// <summary>Whether the macOS menu bar shows Filee's status icon.</summary>
[JsonConverter(typeof(IconPreferenceJsonConverter))]
public bool ShowMenuBarIcon { get; set; } = true;
/// <summary>Newest version the user was already told about, so the update notice shows once per release.</summary>
public string? NotifiedUpdateVersion { get; set; }
/// <summary>
/// The version whose "What's new" slides were last shown (or that was installed fresh, which needs none). Null in
/// settings from before the slides existed: Filee was updated from an older version.
/// </summary>
public string? WhatsNewSeenVersion { get; set; }
/// <summary>Engine package id → the new version the engine update notice was shown for (once per version).</summary>
public Dictionary<string, string> NotifiedEngineVersions { get; set; } = [];
/// <summary>Temporarily disable all trigger gestures (tray "Pause").</summary>
public bool Paused { get; set; }
public ThemeSettings Theme { get; set; } = new();
public DonutSettings Donut { get; set; } = new();
public List<TriggerGesture> Triggers { get; set; } = TriggerGesture.Defaults();
/// <summary>Process names (without .exe) in which gestures never trigger.</summary>
public List<string> ExcludedProcesses { get; set; } = [];
/// <summary>Engine ids in preferred order (see <see cref="Conversion.ConverterCatalog.Priority"/>).</summary>
public List<string> EnginePriority { get; set; } =
[
"magick", "pdfium", "pdfsharp", "rhwp", "unhwp", "markdown", "spreadsheet", "ooxml", "hwpx-writer", "docx-writer",
"pdf-text", "pdf-slides", "email", "data", "vector", "icns", "font", "cad", "model3d", "geo", "archive", "ebook",
"subtitle", "wic", "ffmpeg", "pandoc", "ghostscript", "calibre", "libreoffice",
];
/// <summary>Set once the first-run welcome has been shown.</summary>
public bool FirstRunCompleted { get; set; }
/// <summary>Conversions that succeeded completely, counted until the feedback card has been shown.</summary>
public int SuccessfulConversions { get; set; }
/// <summary>Set once the "Is Filee helping you?" card (GitHub star / feedback) has been shown.</summary>
public bool FeedbackPromptShown { get; set; }
/// <summary>macOS: set once Filee has shown the system's Accessibility alert, which it shows only once (#316).</summary>
public bool AccessibilityPromptShown { get; set; }
/// <summary>Folders whose new files are converted automatically (Settings → Watch folders).</summary>
public List<Watching.WatchRule> WatchFolders { get; set; } = [];
/// <summary>Where presets set to "Default" save (Settings → General).</summary>
public DefaultOutputSettings DefaultOutput { get; set; } = new();
/// <summary>Where files dragged from a web browser are saved (Settings → General).</summary>
public BrowserDropSettings BrowserDrops { get; set; } = new();
/// <summary>
/// Optional engines the user already has: package id ("ffmpeg", "calibre", …) → the program they picked. Used
/// instead of Filee's download (Settings → Engines).
/// </summary>
public Dictionary<string, string> EngineOwnCopies { get; set; } = [];
/// <summary>
/// With LibreOffice installed, presentations (PPTX, PPT, ODP) → PDF go through it instead of the built-in route
/// (HWPX writer and rhwp): slide backgrounds and shape positions come out as in PowerPoint.
/// </summary>
public bool LibreOfficeForSlides { get; set; } = true;
/// <summary>Active local model for offline translation (e.g. "llama3.2", "qwen2.5").</summary>
public string? PreferredOllamaModel { get; set; }
/// <summary>
/// With LibreOffice and H2Orestart installed, HWP / HWPX → PDF go through it instead of rhwp: a way around a
/// document rhwp lays out wrong (each engine gets different documents right).
/// </summary>
public bool LibreOfficeForHwp { get; set; }
/// <summary>
/// With LibreOffice installed, Word documents (DOCX, DOC, ODT, RTF) → PDF go through it instead of the built-in
/// route: Chinese punctuation and line-start rules, fonts the built-in route lacks.
/// </summary>
public bool LibreOfficeForDocuments { get; set; }
/// <summary>
/// With LibreOffice installed, spreadsheets (XLSX, XLS, ODS, CSV) → PDF go through it: print areas, page setup and
/// page breaks as Excel prints them.
/// </summary>
public bool LibreOfficeForSheets { get; set; }
/// <summary>Every conversion keeps the created and modified dates of the original, whatever the preset says.</summary>
public bool KeepFileDates { get; set; }
/// <summary>Every geospatial conversion is saved as a ZIP, whatever the preset says (see <see cref="OutputRule.ZipResult"/>).</summary>
public bool ZipGeoResults { get; set; }
/// <summary>
/// How large Filee's windows draw everything (Theme → Window size; Ctrl + mouse wheel, Ctrl + plus / minus, Ctrl + 0):
/// 1 as designed, 0.7 to 1.8. A missing value (settings from before it) reads as 1, so it needs no schema step.
/// </summary>
public double UiScale { get; set; } = 1;
/// <summary>
/// The main window's navigation is collapsed to an icon rail (the button at its bottom). A missing value (settings from
/// before it) reads as expanded, so it needs no schema step.
/// </summary>
public bool NavCollapsed { get; set; }
/// <summary>
/// Where the main window was when it last closed, so the next start opens it there (#586). Null until it has closed
/// once. A Filee from before it skips the property, so it needs no schema step.
/// </summary>
public WindowBounds? MainWindow { get; set; }
/// <summary>
/// Returns <paramref name="preset"/> itself, or a copy with the app-wide output settings applied: it saves to
/// <see cref="DefaultOutput"/> when the preset's location is <see cref="OutputLocation.Default"/>, and keeps the
/// original dates when <see cref="KeepFileDates"/> is on and is saved as a ZIP when <see cref="ZipGeoResults"/> is on and the
/// target is geospatial. Name pattern and conflict handling stay the preset's.
/// </summary>
public Preset WithDefaultOutput(Preset preset)
{
var location = preset.Output.Location == OutputLocation.Default;
var dates = KeepFileDates && !preset.Output.KeepDates;
var zip = ZipGeoResults && !preset.Output.ZipResult && Formats.FormatRegistry.FindById(preset.TargetFormat)?.Category == Formats.FormatCategory.Geo;
if (!location && !dates && !zip)
return preset;
var copy = preset.Clone();
if (location)
{
copy.Output.Location = DefaultOutput.Location == OutputLocation.Default ? OutputLocation.SameFolder : DefaultOutput.Location;
copy.Output.SubfolderName = DefaultOutput.SubfolderName;
copy.Output.SubfolderOnlyForSeveralFiles = false;
copy.Output.CustomFolder = DefaultOutput.CustomFolder;
}
if (dates)
copy.Output.KeepDates = true;
if (zip)
copy.Output.ZipResult = true;
return copy;
}
}
/// <summary>Reads unexpected icon preference values as enabled while preserving valid booleans.</summary>
internal sealed class IconPreferenceJsonConverter : JsonConverter<bool>
{
public override bool Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options)
{
if (reader.TokenType is JsonTokenType.True or JsonTokenType.False)
return reader.GetBoolean();
reader.Skip();
return true;
}
public override void Write(Utf8JsonWriter writer, bool value, JsonSerializerOptions options) =>
writer.WriteBooleanValue(value);
}
/// <summary>
/// A window's place (<see cref="AppSettings.MainWindow"/>): its top-left corner in screen pixels and its size in
/// device-independent pixels, as Avalonia gives them; a part not known is null. Maximized keeps the size it had before.
/// </summary>
public sealed class WindowBounds
{
public int? X { get; set; }
public int? Y { get; set; }
public double? Width { get; set; }
public double? Height { get; set; }
public bool Maximized { get; set; }
}
/// <summary>The save location presets set to "Default" use. Starts as "next to the source file", as before 1.4.</summary>
public sealed class DefaultOutputSettings
{
/// <summary><see cref="OutputLocation.SameFolder"/>, <see cref="OutputLocation.Subfolder"/> or <see cref="OutputLocation.CustomFolder"/>.</summary>
public OutputLocation Location { get; set; } = OutputLocation.SameFolder;
public string SubfolderName { get; set; } = "converted";
public string CustomFolder { get; set; } = "";
}
/// <summary>Files dragged out of a web browser (Settings → General).</summary>
public sealed class BrowserDropSettings
{
/// <summary>Where they are saved; empty means the user's Downloads folder (looked up each time, as it can move).</summary>
public string Folder { get; set; } = "";
/// <summary>Keep only the converted file: the original goes into a work folder and is deleted after the conversion.</summary>
public bool SaveOnlyConverted { get; set; }
}