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
# Builds the Linux or macOS portable package (tar.gz + SHA256SUMS) on its own operating system. macOS also gets a
# disk image (Filee.app next to an Applications link, to drag it there), signed and notarized as the app is.
#
# Linux packages must run on Ubuntu 22.04 (glibc 2.35). rhwp's Linux release needs a newer glibc, so CI builds it from
# source on Ubuntu 22.04 (build/build-native.py) and passes it in:
# -RhwpOverride <dir> a folder with the rhwp program (rhwp's release archive layout) used instead of the rhwp
# download pinned in engines.json
# Without it (local builds) the package uses the download, which needs a newer glibc.
# Unhwp's NuGet package has no linux-arm64 library; CI builds it the same way and passes it in:
# -UnhwpOverride <file> libunhwp.so, put next to the app (dotnet publish -p:UnhwpNativeLibrary)
# Without it a linux-arm64 package has no Unhwp (HWP/HWPX to text, Markdown and HTML).
#
# macOS packages must run on macOS 13 (LSMinimumSystemVersion). Magick.NET's own macOS ImageMagick library needs macOS
# 14 (Apple silicon) or 15 (Intel), so it is replaced by the same Magick.Native release built for macOS 13
# (.github/workflows/magick-native-macos.yml), pinned below. Every Mach-O file is then checked against
# LSMinimumSystemVersion (build/check-macho-minos.py) before signing.
[CmdletBinding()]
param(
[ValidateSet('linux-x64', 'linux-arm64', 'osx-x64', 'osx-arm64')][string]$Runtime,
[string]$Version,
[string]$OutputDir = (Join-Path $PSScriptRoot '../Releases'),
[string]$SigningIdentity = '-',
[switch]$SkipFonts,
[string]$RhwpOverride,
[string]$UnhwpOverride
)
$ErrorActionPreference = 'Stop'
$root = (Resolve-Path -LiteralPath (Join-Path $PSScriptRoot '..')).Path
if ($IsWindows) { throw 'Create Unix packages on Linux or macOS to preserve executable permissions and sign macOS binaries.' }
if (-not $Runtime) {
$cpu = [Runtime.InteropServices.RuntimeInformation]::ProcessArchitecture.ToString().ToLowerInvariant()
$Runtime = $(if ($IsMacOS) { 'osx' } else { 'linux' }) + "-$cpu"
}
if (($Runtime.StartsWith('osx-') -and -not $IsMacOS) -or ($Runtime.StartsWith('linux-') -and -not $IsLinux)) {
throw "Build $Runtime on its native operating system."
}
if ($RhwpOverride -and -not $Runtime.StartsWith('linux-')) {
throw '-RhwpOverride is for Linux packages.'
}
if ($UnhwpOverride -and $Runtime -ne 'linux-arm64') {
throw '-UnhwpOverride is for linux-arm64 packages (the others get the library from the Unhwp package).'
}
$native = @()
if ($UnhwpOverride) {
$UnhwpOverride = (Resolve-Path -LiteralPath $UnhwpOverride).Path
if ((Split-Path $UnhwpOverride -Leaf) -ne 'libunhwp.so') { throw "-UnhwpOverride: $UnhwpOverride is not libunhwp.so." }
$native = @("-p:UnhwpNativeLibrary=$UnhwpOverride")
}
if ($RhwpOverride) {
$RhwpOverride = (Resolve-Path -LiteralPath $RhwpOverride).Path
if (-not (Test-Path -LiteralPath (Join-Path $RhwpOverride 'rhwp') -PathType Leaf)) {
throw "-RhwpOverride: $RhwpOverride has no rhwp program."
}
}
if (-not $Version) {
$Version = ([xml](Get-Content -LiteralPath (Join-Path $root 'Directory.Build.props') -Raw)).Project.PropertyGroup.Version |
Where-Object { $_ } | Select-Object -First 1
}
$Version = $Version.TrimStart('v')
if ($Version -notmatch '^\d+\.\d+\.\d+(?:-[0-9A-Za-z][0-9A-Za-z.-]*)?$') {
throw 'Version must be a three-part version with an optional prerelease suffix.'
}
$bundleVersion = ($Version -split '-')[0]
$packageName = "Filee-$Version-$Runtime"
New-Item -ItemType Directory -Force -Path $OutputDir | Out-Null
$OutputDir = (Resolve-Path -LiteralPath $OutputDir).Path
$archive = Join-Path $OutputDir "$packageName.tar.gz"
$diskImage = Join-Path $OutputDir "$packageName.dmg"
$sums = Join-Path $OutputDir "$packageName-SHA256SUMS.txt"
if ((Test-Path -LiteralPath $archive) -or (Test-Path -LiteralPath $sums) -or (Test-Path -LiteralPath $diskImage)) {
throw "Package $packageName already exists. Use another output folder or version."
}
# Magick.Native for Magick.NET 14.17.2 built for macOS 13 (#600). A Magick.NET update needs a new build and new pins.
$magickNative = @{
'osx-arm64' = @{
url = 'https://dl.filee.sh/engines/magick-native/2026.927.1314/Magick.Native-Q8-arm64.dll.dylib'
sha256 = '2299d76696d6c78dfbe856fc00118fbe30d684299524bbce328cc76003aa9c02'
}
'osx-x64' = @{
url = 'https://dl.filee.sh/engines/magick-native/2026.927.1314/Magick.Native-Q8-x64.dll.dylib'
sha256 = '11f5e26da1bc67bab6e3c0fdd0375bb756ac2db273356cd0e8f76248137fc5f6'
}
}
$stage = Join-Path $root ('build/.cache/portable/' + [Guid]::NewGuid().ToString('N'))
$package = Join-Path $stage $packageName
$appBundle = Join-Path $package 'Filee.app'
$publish = if ($Runtime.StartsWith('osx-')) { Join-Path $appBundle 'Contents/MacOS' } else { $package }
New-Item -ItemType Directory -Force -Path $publish | Out-Null
function Invoke-Checked([string]$name, [scriptblock]$command) {
& $command
if ($LASTEXITCODE -ne 0) { throw "$name failed with exit code $LASTEXITCODE" }
}
if (-not $SkipFonts) { & (Join-Path $PSScriptRoot 'fetch-fonts.ps1') }
foreach ($project in @('Filee.App', 'Filee.Cli')) {
Invoke-Checked "Publish $project" {
dotnet publish (Join-Path $root "src/$project/$project.csproj") -c Release -r $Runtime --self-contained true `
"-p:Version=$Version" -p:FileeRelease=true -p:PublishReadyToRun=false @native -o $publish
}
}
$engines = Join-Path $publish 'engines'
if ($RhwpOverride) {
& (Join-Path $PSScriptRoot 'fetch-portable-engines.ps1') -Runtime $Runtime -Destination $engines -Only 7zip
Copy-Item -LiteralPath $RhwpOverride -Destination (Join-Path $engines 'rhwp') -Recurse
Invoke-Checked 'rhwp permissions' { chmod +x (Join-Path $engines 'rhwp/rhwp') }
Write-Host "rhwp from $RhwpOverride"
}
else {
& (Join-Path $PSScriptRoot 'fetch-portable-engines.ps1') -Runtime $Runtime -Destination $engines
}
foreach ($name in @('Filee', 'filee-cli')) {
$executable = Join-Path $publish $name
if (-not (Test-Path -LiteralPath $executable -PathType Leaf)) { throw "Publish did not produce $name" }
Invoke-Checked 'Executable permissions' { chmod +x $executable }
}
foreach ($notice in @('LICENSE', 'THIRD-PARTY-NOTICES.md')) {
if (Test-Path -LiteralPath (Join-Path $root $notice)) {
Copy-Item -LiteralPath (Join-Path $root $notice) -Destination $package
}
}
if ($Runtime.StartsWith('osx-')) {
$pin = $magickNative[$Runtime]
$library = Join-Path $publish "Magick.Native-Q8-$($Runtime.Substring(4)).dll.dylib"
if (-not (Test-Path -LiteralPath $library -PathType Leaf)) { throw "Publish did not produce $(Split-Path $library -Leaf)" }
if ($pin.sha256 -notmatch '^[0-9a-fA-F]{64}$') { throw "A pinned Magick.Native download is missing for $Runtime." }
$cache = Join-Path $root 'build/.cache/portable-downloads'
$cached = Join-Path $cache "$($pin.sha256).dylib"
if (-not (Test-Path -LiteralPath $cached)) {
New-Item -ItemType Directory -Force -Path $cache | Out-Null
$download = "$cached.$([Guid]::NewGuid().ToString('N')).partial"
Invoke-WebRequest -Uri $pin.url -OutFile $download
if ((Get-FileHash -LiteralPath $download -Algorithm SHA256).Hash -ne $pin.sha256) {
Remove-Item -LiteralPath $download
throw "Checksum mismatch for Magick.Native ($Runtime)."
}
Move-Item -LiteralPath $download -Destination $cached
}
if ((Get-FileHash -LiteralPath $cached -Algorithm SHA256).Hash -ne $pin.sha256) {
throw "Cached Magick.Native checksum mismatch: $cached"
}
Copy-Item -LiteralPath $cached -Destination $library -Force
Write-Host "Magick.Native for macOS 13 from $($pin.url)"
Invoke-Checked 'Check minimum macOS' { python3 (Join-Path $PSScriptRoot 'check-macho-minos.py') $publish }
$contents = Join-Path $appBundle 'Contents'
$resources = Join-Path $contents 'Resources'
New-Item -ItemType Directory -Path $resources | Out-Null
$info = Get-Content -LiteralPath (Join-Path $root 'installer/macos/Info.plist') -Raw
$info.Replace('__VERSION__', $bundleVersion).Replace('__BUNDLE_VERSION__', $bundleVersion) |
Set-Content -LiteralPath (Join-Path $contents 'Info.plist') -Encoding utf8NoBOM
Invoke-Checked 'Validate Info.plist' { plutil -lint (Join-Path $contents 'Info.plist') }
$iconset = Join-Path $stage 'filee.iconset'
New-Item -ItemType Directory -Path $iconset | Out-Null
$sourceIcon = Join-Path $root 'src/Filee.App/Assets/Icons/filee.png'
foreach ($size in @(16, 32, 128, 256, 512)) {
foreach ($scale in @(1, 2)) {
$pixels = $size * $scale
$suffix = if ($scale -eq 2) { '@2x' } else { '' }
$target = Join-Path $iconset "icon_${size}x${size}$suffix.png"
Invoke-Checked 'Render app icon' { sips -z $pixels $pixels $sourceIcon --out $target | Out-Null }
}
}
Invoke-Checked 'Create app icon' { iconutil -c icns $iconset -o (Join-Path $resources 'filee.icns') }
# Translations of the service title ("Convert with Filee") in Finder's right-click menu.
foreach ($localization in Get-ChildItem -LiteralPath (Join-Path $root 'installer/macos') -Directory -Filter '*.lproj') {
foreach ($stringsFile in Get-ChildItem -LiteralPath $localization.FullName -File -Filter '*.strings') {
Invoke-Checked 'Validate localized strings' { plutil -lint $stringsFile.FullName }
}
Copy-Item -LiteralPath $localization.FullName -Destination $resources -Recurse
}
$entitlements = Join-Path $root 'installer/macos/entitlements.plist'
$signOptions = @('--force', '--sign', $SigningIdentity)
if ($SigningIdentity -ne '-') { $signOptions += @('--timestamp', '--options', 'runtime') }
# Every file in Contents/MacOS is code to codesign, the .NET assemblies too (their signature goes into extended
# attributes): signing the main executable checks all of them. Deepest paths first, the main executable last.
$mainExecutable = Join-Path $publish 'Filee'
$files = Get-ChildItem -LiteralPath $publish -Recurse -File | Where-Object { $_.FullName -ne $mainExecutable } |
Sort-Object { $_.FullName.Length } -Descending
foreach ($file in $files) {
Invoke-Checked "Sign $($file.Name)" { codesign @signOptions --entitlements $entitlements $file.FullName }
}
Invoke-Checked 'Sign main executable' { codesign @signOptions --entitlements $entitlements $mainExecutable }
Invoke-Checked 'Sign app bundle' { codesign @signOptions --entitlements $entitlements $appBundle }
Invoke-Checked 'Verify app signature' { codesign --verify --deep --strict $appBundle }
Copy-Item -LiteralPath (Join-Path $root 'installer/macos/install.sh') -Destination $package
Copy-Item -LiteralPath (Join-Path $root 'installer/macos/uninstall.sh') -Destination $package
Copy-Item -LiteralPath (Join-Path $root 'installer/macos/INSTALL.txt') -Destination $package
}
else {
Copy-Item -LiteralPath (Join-Path $root 'src/Filee.App/Assets/Icons/filee.png') -Destination $package
Copy-Item -LiteralPath (Join-Path $root 'installer/linux/install.sh') -Destination $package
Copy-Item -LiteralPath (Join-Path $root 'installer/linux/uninstall.sh') -Destination $package
Copy-Item -LiteralPath (Join-Path $root 'installer/linux/INSTALL.txt') -Destination $package
Copy-Item -LiteralPath (Join-Path $root 'installer/linux/kwin') -Destination $package -Recurse
Copy-Item -LiteralPath (Join-Path $root 'installer/linux/gnome') -Destination $package -Recurse
Copy-Item -LiteralPath (Join-Path $root 'docs/GNOME-WAYLAND.md') -Destination $package
}
Invoke-Checked 'Installer permissions' { chmod +x (Join-Path $package 'install.sh') (Join-Path $package 'uninstall.sh') }
$temporaryArchive = "$archive.$([Guid]::NewGuid().ToString('N')).partial"
Invoke-Checked 'Create tar.gz' { tar -czf $temporaryArchive -C $stage $packageName }
Move-Item -LiteralPath $temporaryArchive -Destination $archive
$packages = @($archive)
if ($Runtime.StartsWith('osx-')) {
# The same signed Filee.app, next to a link to /Applications to drag it onto. ditto keeps the signature's
# extended attributes. install.sh (in the tar.gz) is still the way to get the filee command.
$volume = Join-Path $stage 'dmg'
New-Item -ItemType Directory -Path $volume | Out-Null
Invoke-Checked 'Copy app for the disk image' { ditto $appBundle (Join-Path $volume 'Filee.app') }
Invoke-Checked 'Applications link' { ln -s /Applications (Join-Path $volume 'Applications') }
Copy-Item -LiteralPath (Join-Path $root 'installer/macos/INSTALL.txt') -Destination $volume
$temporaryImage = "$diskImage.$([Guid]::NewGuid().ToString('N')).partial.dmg"
Invoke-Checked 'Create dmg' { hdiutil create -volname Filee -srcfolder $volume -fs HFS+ -format UDZO -ov $temporaryImage | Out-Null }
Move-Item -LiteralPath $temporaryImage -Destination $diskImage
$packages += $diskImage
}
$packages | ForEach-Object { "$((Get-FileHash -LiteralPath $_ -Algorithm SHA256).Hash.ToLowerInvariant()) $(Split-Path $_ -Leaf)" } |
Set-Content -LiteralPath $sums -Encoding ascii
Write-Host "Package: $($packages -join ', ')"
Write-Host "Checksums: $sums"
Write-Host "Unpacked build retained for testing: $package"
if ($Runtime.StartsWith('osx-') -and $SigningIdentity -eq '-') {
Write-Host 'This macOS build is ad-hoc signed for testing; it is not notarized for public distribution.'
}