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
// The sparse ("packaged with external location") MSIX that puts "Convert with Filee" into the top-level Windows 11
// File Explorer context menu. The package holds only AppxManifest.xml and a logo; the COM server it declares is the
// native FileeExplorerMenu.dll in the Filee install folder (src/Filee.ExplorerMenu).
using System.Globalization;
using System.Xml.Linq;
namespace Filee.Platform.Windows;
/// <summary>
/// Identity, file names and manifest of the Explorer context-menu package. build/tools/make-explorer-package.cs packs
/// <see cref="CreateManifest"/> at build time; <see cref="ExplorerMenuRegistration"/> registers the result.
/// </summary>
public static class ExplorerMenuPackage
{
/// <summary>Package name (the <c>Identity/@Name</c>); also used to find and remove the registration.</summary>
public const string PackageName = "Filee.ExplorerMenu";
/// <summary>
/// Publisher of the unsigned package. Windows 11 only registers unsigned packages whose publisher contains this
/// special OID, so they can never collide with (or spoof) a signed package.
/// </summary>
public const string Publisher = "CN=Filee, OID.2.25.311729368913984317654407730594956997722=1";
/// <summary>
/// Package family name = name + "_" + a hash of <see cref="Publisher"/> (checked by a test against
/// <c>PackageFamilyNameFromId</c>). Used to look the registration up without PowerShell.
/// </summary>
public const string FamilyName = "Filee.ExplorerMenu_c73vxh346rtay";
/// <summary>
/// Version of the manifest, deliberately independent of the app version: registering an unsigned package with a
/// COM server needs administrator rights, so the package must stay valid across app updates (the DLL itself is
/// loaded from the install folder and is updated with the app). Bump it only when the manifest changes; the app
/// then offers to register again.
/// </summary>
public static readonly Version ManifestVersion = new(1, 0, 0, 0);
/// <summary>CLSID of the IExplorerCommand in FileeExplorerMenu.dll (kClsidCommand in FileeExplorerMenu.c).</summary>
public static readonly Guid ClassId = new("6DB0E670-807F-4D22-BE3F-20492D0F4AB1");
/// <summary>The native COM server next to Filee.exe.</summary>
public const string DllFileName = "FileeExplorerMenu.dll";
/// <summary>The package file next to Filee.exe.</summary>
public const string PackageFileName = "FileeExplorerMenu.msix";
/// <summary>
/// File in the data folder (%APPDATA%\Filee, TITLE_FILE in FileeExplorerMenu.c) whose first line is the menu title
/// in the UI language. It exists while the Explorer menu setting is on; without it the DLL hides the entry.
/// </summary>
public const string TitleFileName = "explorer-menu.txt";
/// <summary>
/// Processor architecture of the DLL (it is loaded into explorer.exe, so it must match Explorer) when the build
/// names none: x64. ARM64 builds of Filee ship an ARM64 DLL in an "arm64" package.
/// </summary>
public const string Architecture = "x64";
/// <summary>The package architectures <see cref="CreateManifest"/> accepts (build/build-explorer-menu.ps1 -Architecture).</summary>
public static IReadOnlyList<string> Architectures { get; } = ["x64", "arm64"];
/// <summary>Windows 11 (build 22000) is the first version with the new context menu and unsigned packages.</summary>
public const int MinimumBuild = 22000;
/// <summary>Path of the logo inside the package (shown in package lists only; the menu uses Filee.exe's icon).</summary>
public const string LogoPath = @"Assets\Logo.png";
private static readonly XNamespace Foundation = "http://schemas.microsoft.com/appx/manifest/foundation/windows10";
private static readonly XNamespace Uap = "http://schemas.microsoft.com/appx/manifest/uap/windows10";
private static readonly XNamespace Uap10 = "http://schemas.microsoft.com/appx/manifest/uap/windows10/10";
private static readonly XNamespace Desktop4 = "http://schemas.microsoft.com/appx/manifest/desktop/windows10/4";
private static readonly XNamespace Desktop5 = "http://schemas.microsoft.com/appx/manifest/desktop/windows10/5";
private static readonly XNamespace Com = "http://schemas.microsoft.com/appx/manifest/com/windows10";
private static readonly XNamespace Rescap = "http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities";
/// <summary>
/// Builds AppxManifest.xml for a DLL built for <paramref name="architecture"/> (one of <see cref="Architectures"/>).
/// Paths in it (Filee.exe, the DLL) are relative to the external location, i.e. the install folder given at
/// registration.
/// </summary>
public static string CreateManifest(string architecture = Architecture)
{
if (!Architectures.Contains(architecture))
throw new ArgumentOutOfRangeException(nameof(architecture), architecture, $"Expected one of {string.Join(", ", Architectures)}.");
var clsid = ClassId.ToString("D").ToUpperInvariant();
var package = new XElement(Foundation + "Package",
new XAttribute("xmlns", Foundation.NamespaceName),
new XAttribute(XNamespace.Xmlns + "uap", Uap),
new XAttribute(XNamespace.Xmlns + "uap10", Uap10),
new XAttribute(XNamespace.Xmlns + "desktop4", Desktop4),
new XAttribute(XNamespace.Xmlns + "desktop5", Desktop5),
new XAttribute(XNamespace.Xmlns + "com", Com),
new XAttribute(XNamespace.Xmlns + "rescap", Rescap),
new XAttribute("IgnorableNamespaces", "uap uap10 desktop4 desktop5 com rescap"),
new XElement(Foundation + "Identity",
new XAttribute("Name", PackageName),
new XAttribute("Publisher", Publisher),
new XAttribute("Version", ManifestVersion.ToString(4)),
new XAttribute("ProcessorArchitecture", architecture)),
new XElement(Foundation + "Properties",
new XElement(Foundation + "DisplayName", "Filee"),
new XElement(Foundation + "PublisherDisplayName", "Filee contributors"),
new XElement(Foundation + "Logo", LogoPath),
new XElement(Uap10 + "AllowExternalContent", "true")),
new XElement(Foundation + "Resources",
new XElement(Foundation + "Resource", new XAttribute("Language", "en-us"))),
new XElement(Foundation + "Dependencies",
new XElement(Foundation + "TargetDeviceFamily",
new XAttribute("Name", "Windows.Desktop"),
new XAttribute("MinVersion", "10.0." + MinimumBuild.ToString(CultureInfo.InvariantCulture) + ".0"),
new XAttribute("MaxVersionTested", "10.0.26100.0"))),
new XElement(Foundation + "Capabilities",
new XElement(Rescap + "Capability", new XAttribute("Name", "runFullTrust")),
new XElement(Rescap + "Capability", new XAttribute("Name", "unvirtualizedResources"))),
new XElement(Foundation + "Applications",
new XElement(Foundation + "Application",
new XAttribute("Id", "Filee"),
new XAttribute("Executable", "Filee.exe"),
new XAttribute(Uap10 + "TrustLevel", "mediumIL"),
new XAttribute(Uap10 + "RuntimeBehavior", "win32App"),
// AppListEntry="none": the package only carries the shell extension, it adds no Start menu entry.
new XElement(Uap + "VisualElements",
new XAttribute("AppListEntry", "none"),
new XAttribute("DisplayName", "Filee"),
new XAttribute("Description", "Filee File Explorer integration"),
new XAttribute("BackgroundColor", "transparent"),
new XAttribute("Square150x150Logo", LogoPath),
new XAttribute("Square44x44Logo", LogoPath)),
new XElement(Foundation + "Extensions",
// Type="*": files only (folders would be "Directory"); the DLL additionally hides the
// command for virtual items (e.g. inside a ZIP folder) and mixed selections.
new XElement(Desktop4 + "Extension",
new XAttribute("Category", "windows.fileExplorerContextMenus"),
new XElement(Desktop4 + "FileExplorerContextMenus",
new XElement(Desktop5 + "ItemType",
new XAttribute("Type", "*"),
new XElement(Desktop5 + "Verb",
new XAttribute("Id", "ConvertWithFilee"),
new XAttribute("Clsid", clsid))))),
new XElement(Com + "Extension",
new XAttribute("Category", "windows.comServer"),
new XElement(Com + "ComServer",
new XElement(Com + "SurrogateServer",
new XAttribute("DisplayName", "Filee context menu"),
new XElement(Com + "Class",
new XAttribute("Id", clsid),
new XAttribute("Path", DllFileName),
new XAttribute("ThreadingModel", "STA")))))))));
var document = new XDocument(new XDeclaration("1.0", "utf-8", null), package);
return document.Declaration + Environment.NewLine + document.Root;
}
}