x-files-uwp

KO | EN

gitlite — search

#automation #ui #devops #hacktoberfest #proxy #claude-code #generative-ai #data-science #api #web

(★ 9)

No description available.

파일 탐색기

ZIP 다운로드

- index.sqlite
- - bug_report.md
  - feature_request.md
- - ci.yml
- - crispy-fluttering-puffin.md
- - default.html
- - ARCHITECTURE.md
  - IMPLEMENTATION.md
  - README.md
  - SPEC.md
- - folder-blue-512.png
  - folder-darkcyan-512.png
  - folder-deeporange-512.png
  - folder-green-512.png
  - folder-indigo-512.png
  - folder-magenta-512.png
  - folder-orange-512.png
  - folder-yaru-512.png
  - folder-yellow-512.png
- - logo-big.png
  - logo-top-transparent.png
  - logo-transparent.png
  - social-preview.jpg
  - social-preview.psd
- - ARCHITECTURE.md
  - DECISIONS.md
  - gemini-chat-2026-08-13T07-15-13-835Z.md
  - gemini-chat-2026-08-15T21-21-05-054Z.md
  - IMPLEMENTATION.md
  - PLAN.md
  - README.md
  - SPEC.md
  - WEBDAV-PLAN.md
- - CHECKLIST.md
  - PLAN.md
- - music-player.jpg
  - xfiles-01-splash.jpg
  - xfiles-02-welcome.jpg
  - xfiles-03-spinup-hdd.jpg
  - xfiles-04-about.jpg
  - xfiles-05-xml-highlight.jpg
  - xfiles-06-highlight1.jpg
  - xfiles-07-highlight2.jpg
  - xfiles-08-image-viewer.jpg
  - xfiles-09-pdf-viewer-full.jpg
  - xfiles-09-pdf-viewer.jpg
  - xfiles-10-svg-viewer.jpg
  - xfiles-11-music-player-full.jpg
  - xfiles-12-viz1.jpg
  - xfiles-13-viz2.jpg
  - xfiles-14-viz3.jpg
  - xfiles-15-viz4.jpg
  - xfiles-16-viz5.jpg
  - xfiles-17-viz6.jpg
  - xfiles-18-viz7.jpg
  - xfiles-19-viz8.jpg
  - xfiles-20-viz9.jpg
  - xfiles-21-viz10.jpg
  - xfiles-22-viz11.jpg
  - xfiles-23-viz12.jpg
  - xfiles-24-viz13.jpg
  - xfiles-25-fileops.jpg
  - xfiles-25-share1.jpg
  - xfiles-26-share2.jpg
  - xfiles-27-share-progress.jpg
  - xfiles-28-share-qr.jpg
  - xfiles-29-batch-selection.jpg
  - xfiles-30-batch-operation.jpg
  - xfiles-32-progress.jpg
  - xfiles-33-progress-paste.jpg
  - xfiles-34-roms.jpg
  - xfiles-35-edit-file.jpg
  - xfiles-36-editor.jpg
  - xfiles-37-logs.jpg
  - xfiles-38-logs-share.jpg
  - xfiles-39-delete.jpg
  - xfiles-40-delete1.jpg
  - xfiles-41-new-folder.jpg
  - xfiles-42-move-here.jpg
  - xfiles-43-move-here.jpg
  - xfiles-44-settings.jpg
  - xfiles-45-video-player.jpg
  - xfiles-46-video-player-full.jpg
- - 01-architecture.md
  - 02-error-handling.md
  - 03-uwp-compliance.md
  - 04-async-patterns.md
  - 05-code-duplication.md
  - 06-misc.md
  - README.md
- - ARCHITECTURE.md
  - EDGE-CASES.md
  - ENCODING.md
  - IMPLEMENTATION-PLAN.md
  - INPUT-MAPPING.md
  - SPEC.md
- _config.yml
- ARCHITECTURE.md
- ARCHIVES.md
- ASSETS-GUIDE.md
- ATTRIBUTIONS.md
- AUDIO-VISUALIZATION.md
- AUDIO-VISUALIZERS.md
- DECISIONS.md
- DEPLOY-XBOX.md
- DEVELOPERS.md
- FILE-SHARES.md
- FILE-SHARING-QR.md
- FILEBROWSER.md
- FILETYPE-ICONS.md
- GAMEPAD.md
- index.md
- LOGGING.md
- mainpage-network-tip-shared-32.psd
- network-protocols.psd
- PHASE2-TESTS.md
- PORTAL-APPDATA.md
- RELEASE.md
- ROADMAP.md
- ROM-FORMATS.md
- SETTINGS-EXPANSION.md
- social-preview.png
- SPEC.md
- UI-THEMING.md
- USER-FILES.md
- build.ps1
- clean.ps1
- copy-gamepad-icons.ps1
- package.ps1
- run.ps1
- status.ps1
- - EncodingSetup.cs
  - FileOperationsStubs.cs
  - LogStub.cs
- ArchiveSubtreeStatsTests.cs
- ClipboardStateTests.cs
- ConflictDecisionTests.cs
- coverage.runsettings
- DirectoryScannerTests.cs
- DirectoryStatsCalculatorTests.cs
- DiskSpaceGuardTests.cs
- DownloadHelpersTests.cs
- EncodingDetectorTests.cs
- FftHelperTests.cs
- FileEntryTests.cs
- FilenameParserTests.cs
- FilePreviewLimitsTests.cs
- FormattingTests.cs
- FtpSessionSmokeTests.cs
- HighlightRendererTests.cs
- HostKeyTrustStoreTests.cs
- Id3TagTests.cs
- MediaMetadataProbeTests.cs
- MetadataMatchTests.cs
- MusicFormatClassifierTests.cs
- NetworkCopyServiceTests.cs
- NetworkOperationExceptionTests.cs
- NetworkPathUtilTests.cs
- NetworkServerStoreTests.cs
- NetworkUrlTests.cs
- PieGeometryTests.cs
- PortalCoreTests.cs
- RomCoverProviderTests.cs
- RomHeaderParserTests.cs
- SftpSessionSmokeTests.cs
- SmbSessionSmokeTests.cs
- TextEditorServiceTests.cs
- TrackMetadataTests.cs
- TransferMeterTests.cs
- TransferStatsTests.cs
- WebDavSessionTests.cs
- WebDavSmokeTests.cs
- Win32FileStreamTests.cs
- Win32FileWriteStreamTests.cs
- XFiles.Tests.csproj
- - .gitignore
  - CONNECTIONS.md
  - docker-compose.yml
  - make-seed.ps1
- generate-devportal-secrets.ps1
- increment-version.ps1
- liberate-loopback.ps1
- liberate-loopback.sh
- README-LIBERATE.md
- - editor.js
  - highlight-aco.css
  - highlight-vs2015.min.css
  - highlight.min.js
  - HurmitNerdFont-Regular.otf
  - LockScreenLogo.scale-200.png
  - logo.png
  - mac-startup.mp3
  - README.md
  - social-preview.png
  - SplashScreen.png
  - SplashScreen.scale-200.png
  - Square150x150Logo.png
  - Square150x150Logo.scale-200.png
  - Square310x310Logo.scale-200.png
  - Square44x44Logo.png
  - Square44x44Logo.scale-200.png
  - Square44x44Logo.targetsize-24_altform-unplated.png
  - Square71x71Logo.png
  - Square71x71Logo.scale-200.png
  - StoreLogo.png
  - Wide310x150Logo.png
  - Wide310x150Logo.scale-200.png
- - AudioLevelService.cs
  - BackgroundMusicService.cs
  - FftHelper.cs
  - IMemoryBufferAccess.cs
  - RetroAudioPlayer.cs
- - README.md
- - AlertDialog.xaml
  - AlertDialog.xaml.cs
  - ColumnListView.xaml
  - ColumnListView.xaml.cs
  - ControlsGuideOverlay.xaml
  - ControlsGuideOverlay.xaml.cs
  - Converters.cs
  - CounterPage.xaml
  - CounterPage.xaml.cs
  - DirectoryTestPage.xaml
  - DirectoryTestPage.xaml.cs
  - DiskUsageDialog.xaml
  - DiskUsageDialog.xaml.cs
  - FileActionSheet.xaml
  - FileActionSheet.xaml.cs
  - FileConflictDialog.xaml
  - FileConflictDialog.xaml.cs
  - FileOperationConfirmDialog.xaml
  - FileOperationConfirmDialog.xaml.cs
  - FilePropertiesDialog.xaml
  - FilePropertiesDialog.xaml.cs
  - FolderBrowserDialog.xaml
  - FolderBrowserDialog.xaml.cs
  - GamepadLegend.xaml
  - GamepadLegend.xaml.cs
  - HostKeyDialog.xaml
  - HostKeyDialog.xaml.cs
  - ImageFullScreenOverlay.xaml
  - ImageFullScreenOverlay.xaml.cs
  - InputDialog.xaml
  - InputDialog.xaml.cs
  - LetterGridOverlay.xaml
  - LetterGridOverlay.xaml.cs
  - LogsPage.xaml
  - LogsPage.xaml.cs
  - MediaPreviewControl.xaml
  - MediaPreviewControl.xaml.cs
  - MillerColumnsPage.Error.cs
  - MillerColumnsPage.FileOps.cs
  - MillerColumnsPage.Media.cs
  - MillerColumnsPage.Navigation.cs
  - MillerColumnsPage.Preview.cs
  - MillerColumnsPage.RomCover.cs
  - MillerColumnsPage.xaml
  - MillerColumnsPage.xaml.cs
  - NetworkLocationDialog.xaml
  - NetworkLocationDialog.xaml.cs
  - OperationProgressDialog.xaml
  - OperationProgressDialog.xaml.cs
  - OverwriteDialog.xaml
  - OverwriteDialog.xaml.cs
  - PdfFullScreenOverlay.xaml
  - PdfFullScreenOverlay.xaml.cs
  - PermissionsDialog.xaml
  - PermissionsDialog.xaml.cs
  - PieGeometry.cs
  - PortalCredentialsDialog.xaml
  - PortalCredentialsDialog.xaml.cs
  - PortalSetupDialog.xaml
  - PortalSetupDialog.xaml.cs
  - README.md
  - SettingsPage.xaml
  - SettingsPage.xaml.cs
  - ShareDialog.xaml
  - ShareDialog.xaml.cs
  - StartMenu.xaml
  - StartMenu.xaml.cs
  - TextEditorOverlay.xaml
  - TextEditorOverlay.xaml.cs
  - TransferStats.cs
  - UrlDownloadOverlay.xaml
  - UrlDownloadOverlay.xaml.cs
  - VideoTrackMenu.xaml
  - VideoTrackMenu.xaml.cs
  - VuMeterBar.xaml
  - VuMeterBar.xaml.cs
- - ArchiveBrowser.cs
  - ArchiveSubtreeStats.cs
  - ChiptuneBrowser.cs
  - ClipboardState.cs
  - ConflictDecision.cs
  - DirectoryEntryOrder.cs
  - DirectoryScanner.cs
  - DirectoryStatsCalculator.cs
  - DiskSpaceGuard.cs
  - EncodingDetector.cs
  - FavoritesManager.cs
  - FileEntry.cs
  - FileOperations.cs
  - FilePreviewLimits.cs
  - FilePreviewService.cs
  - Formatting.cs
  - GamelistParser.cs
  - HighlightRenderer.cs
  - Id3Tag.cs
  - MusicFormatClassifier.cs
  - OperationProgress.cs
  - PortalBrowser.cs
  - README.md
  - RomCoverProvider.cs
  - RomHeaderParser.cs
  - SubtitleDetector.cs
  - TextEditorService.cs
  - TransferMeter.cs
  - Win32FileStream.cs
  - Win32FileWriteStream.cs
- - DeezerProvider.cs
  - FilenameParser.cs
  - MediaMetadataProbe.cs
  - MetadataCache.cs
  - MetadataCacheDb.cs
  - MetadataGuesser.cs
  - MetadataMatch.cs
  - MusicBrainzProvider.cs
  - TrackMetadata.cs
- - build-native.ps1
- - ColumnNavigator.cs
  - GamepadInputService.cs
  - INavigable.cs
  - InputRouter.cs
  - README.md
- - FtpBrowser.cs
  - FtpSession.cs
  - HostKeyTrustStore.cs
  - INetworkFileSystemProvider.cs
  - NetworkCopyService.cs
  - NetworkFileEntry.cs
  - NetworkOperationException.cs
  - NetworkPathUtil.cs
  - NetworkProtocol.cs
  - NetworkProviderFactory.cs
  - NetworkServerConfig.cs
  - NetworkServerManager.cs
  - NetworkServerStore.cs
  - NetworkUrl.cs
  - RemoteStream.cs
  - SftpBrowser.cs
  - SftpReadStream.cs
  - SftpSession.cs
  - SftpWriteStream.cs
  - SmbBrowser.cs
  - SmbReadStream.cs
  - SmbSession.cs
  - SmbWriteStream.cs
  - WebDavBrowser.cs
  - WebDavReadStream.cs
  - WebDavSession.cs
  - WebDavWriteStream.cs
- - AssemblyInfo.cs
- - DevicePortalService.cs
  - DownloadHelpers.cs
  - DownloadService.cs
  - FileShareService.cs
  - PdfPreviewService.cs
  - PortalCache.cs
  - PortalCore.cs
  - PortalModels.cs
  - ProgressStream.cs
- - XFilesSettings.cs
- - BladeTheme.xaml
  - README.md
- - AudioData.cs
  - AudioFullscreenMode.cs
  - AudioVisualizerBase.cs
  - IAudioVisualizer.cs
  - PostProcessPipeline.cs
  - VisualizerRegistry.cs
- App.xaml
- App.xaml.cs
- Default.rd.xml
- Log.cs
- MainPage.xaml
- MainPage.xaml.cs
- Package.appxmanifest
- XFiles.csproj
.env.example
.gitignore
AGENTS.md
bugs-ideias.txt
build_counter.txt
LICENSE
README.md
RELEASE-NOTES.md
version.props
version.txt
XFiles.sln

# CDN으로 사용하기

jsDelivr

jsDelivr는 공개 GitHub 리포지토리를 별도 설정 없이 CDN으로 즉시 서빙합니다. 버전과 파일을 고르면 웹페이지에 바로 붙일 수 있는 링크와 예시 코드가 만들어집니다.

버전

파일

링크

예시

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align="center">X-Files</h1>

🎮 The file manager your Xbox deserves. 
 Navigate, preview, play, and manage your files — all from the couch, all with a gamepad.

<a href="#-features">Features</a> ·
 <a href="#-controls">Controls</a> ·
 <a href="#-screenshots">Screenshots</a> ·
 <a href="#-getting-started">Get Started</a> ·
 <a href="#-documentation">Docs</a>

---

## 🤔 Why X-Files?

Xbox has no built-in way to browse files on USB drives, preview images, listen to music,
or manage your media library. **X-Files fills that gap** — a full-featured file manager
built specifically for the couch experience.

Miller-column navigation · Live preview · Network browsing · Audio player with VU meter · Archive browsing · Retro aesthetic

---

## ✨ Features

### 📂 Three-Column File Browser
Browse your files like a pro with a Miller-column layout — **Parent | Current | Preview**.
See where you are, what's here, and what's inside — all at once. Drill into folders with
**A** and back out with **B**.

- 🖥️ Browse all connected drives (internal + USB)
- 📁 Folders-first sorting, alphabetical within type
- 🔒 Hidden/system files filtered automatically
- ⚡ Blazing fast — P/Invoke directory scanning, navigates thousands of files without lag

### 👀 Live Preview
Move the cursor over any file and instantly see its contents — no need to open it first.

| Format | Preview |
|--------|---------|
| 📄 Text / Log / Markdown | Plain text with scroll |
| 🖼️ Images (PNG, JPG, BMP, GIF, WebP) | Thumbnail with size info |
| 🎨 SVG | Rendered in WebView |
| 💻 Code (40+ languages) | Syntax highlighting via highlight.js |
| 🎵 Audio (MP3, FLAC, OGG, WAV) | ID3 metadata + album art + VU meter |
| 🕹️ Chiptune (SPC, PSF, GBS, NSF, VGM...) | Native playback — console music plays right in the preview |
| 🎬 Video (MP4, MKV, AVI) | Inline playback with transport controls |
| 📖 PDF | Page preview + fullscreen viewer |
| 🎮 ROMs (NES, SNES, GB/GBA, Genesis...) | Header-parsed title + system icon |
| 📦 Archives (ZIP, 7Z, RAR) | Browse contents as virtual folders |
| 🌐 Network files | Streaming preview from SMB/FTP/FTPS/SFTP/WebDAV servers |

### 🎵 Built-in Audio Player
Play music directly from the file browser with a real-time spectrum analyzer.
Pause, seek, skip tracks, adjust volume — all from the gamepad. *Winamp vibes on your Xbox.*

- 🔊 Real-time VU meter with green → yellow → red gradient
- 🎨 Fullscreen mode with album art and track metadata
- ✨ **31 audio visualizers** (Win2D + HLSL shaders), cycle with **Select**,
  picker via long-press **Select**
- 🎼 **Metadata guesser** — ID3 tags + filename parsing + MusicBrainz enrichment,
  cached in SQLite
- 🔀 Auto-advance to next track
- 🔉 Volume control via analog stick

### 🕹️ Chiptune / Tracker Player
Play console music and tracker files natively — no conversion needed, all from the couch.

- 🎮 **43+ formats**: console chips (SPC, GBS, NSF, VGM, SID, HES, KSS, AY, SAP, GYM)
  via game-music-emu, trackers (MOD, XM, S3M, IT + 20 more) via libopenmpt, and
  PSF/miniPSF + USF/miniUSF (PlayStation & Nintendo 64)
- ⚡ **Plays while it renders** — first sound in ~1s, full render finishes in the background
- 📂 Browse multi-subsong archives (e.g. `.rsn` → SPC) and drill into track lists
- 🎵 Fullscreen player with next/prev, seek, spinner, and VU meter
- 🔄 Cached WAVs for instant replay on next visit

### 🎶 Background Music
The X-Files menu itself can play music while you browse.

- 🎵 A bundled track plays by default (Donkey Kong Country 2 — *Stickerbrush Symphony*)
- ⚙️ Settings: enable/disable, pick your own file, set volume (10–100%)
- 🎼 Chiptune files auto-convert to WAV on first use
- 🕰️ Pauses when you play media, resumes with a fade-in after 10s of silence

### 🎬 Video Player
Watch videos directly from the file browser with a clean fullscreen experience.

- ▶️ Play/pause with **A** button
- ⏪ Seek 5 seconds with **LB/RB**
- 🔊 Volume control via left analog stick
- 📝 Subtitle support (external `.srt` files auto-detected)
- 🔀 Audio track + subtitle track switching (multi-language files)
- 🎯 Clean OSD with transport controls

### 📦 Archive Explorer
Navigate inside **ZIP**, **7Z**, and **RAR** files as if they were folders. Preview text
and images inside archives without extracting. When you do extract, X-Files is smart:

- 🧠 **Smart extraction** — single-root archives extract in-place, multi-root create a folder
- 🔀 **Conflict resolution** — overwrite / overwrite all / skip per file
- 📁 **Extract to folder** or **extract here** — your choice
- 🌐 **Remote archives** — ZIP/7Z/RAR on SMB/FTP/FTPS/SFTP/WebDAV extract straight to any
  destination via streaming, no local download first

### 🌐 Network File Browser
Mount your home media from the couch — Windows/Samba shares, FTP servers, SSH (SFTP),
and WebDAV all appear in the left column under **Network**.

- 🔌 **Four protocols** — SMB, FTP/FTPS (implicit + explicit TLS), SFTP, WebDAV
- 🔐 **Credential Vault** — passwords stored in Windows PasswordVault, never on disk
- 📡 **Streaming preview** — text, images, audio, video, and chiptunes play directly from
  the server without downloading the whole file
- 📁 **Full remote operations** — copy/move/rename/delete, batch operations, create
  folders, and extract remote archives, all with live progress
- 🔒 **Write-permission detection** — read-only folders surface a clear alert before you act
- 📦 **Smart archive handling** — large remote archives (128MB+) defer to a one-time cache
  download with progress and cancel, smaller ones list straight over the wire
- 🧭 **Breadcrumb protocol icons** — each network location shows its protocol in the address bar

### 🛠️ File Operations
All the essentials, accessible from the **Y button** context menu:

- 📝 Rename with text input dialog
- 🗑️ Delete with file list confirmation
- 📋 Copy / Move / Paste — destination picker with separator-separated drives, live progress
- 📦 Extract archives to any destination
- 🗜️ Create ZIP from files or folders
- 📁 Create new folder
- ⭐ Add/remove favorites
- 🔄 Refresh current directory
- 📋 **Batch mode** — Select toggles multi-select; copy/move/delete entire batches at once
- 🔍 **Properties** — full file/folder metadata, compression visual, and permissions (below)

### 📑 Properties Dialog (Y menu)
Inspect any file or folder from the **Y** button without leaving the couch:

- 🗂️ **Folders** — total size, file/folder counts, created/modified/accessed dates, and a
  live **pie chart** showing the folder's share of its drive (scan updates incrementally
  as it walks, with an indeterminate progress bar and **B** to cancel)
- 📦 **Archives** — uncompressed size, file count, compression **ratio** and **saved %**,
  drawn as a WinRAR-style **isometric 3D cube** (green = compressed data, blue = space saved)
- 🖼️ **Images** — dimensions (PNG, GIF, BMP, JPEG)
- 📖 **PDF** — page count
- 🎵 **Audio** — duration, bitrate, sample rate, channels, codec (MP3, FLAC, WAV, M4A)
- 📄 **Text** — line, word, and character counts
- 🕐 **Timestamps** — created / modified / accessed dates for every item
- 🔐 **Permissions** — read-only and hidden toggles, with optional apply to subfolders
  and files

### 🖊️ Text Editor
Edit text files right on the couch with a fullscreen, gamepad-first editor:

- 💡 Syntax highlighting for 40+ languages (highlight.js)
- ⌨️ System virtual keyboard (gamepad-native, no hardware keyboard needed)
- 📏 Three size tiers: full edit + highlight → edit without highlight → read-only
- 💾 Save via **Start**; dirty-state confirmation on exit
- 🔤 Encoding detection (UTF-8/16, Windows-1252) with BOM/line-ending preservation

### 🔗 Share via QR
Share any file or folder as a **QR code** in seconds:

- 📤 Uploads to gofile.io, displays a scannable QR with a short URL
- 📋 Share app logs the same way for easy bug reporting
- ✅ Perfect for moving files between Xbox and phone/PC

### 📥 Download from URL
Download files straight to disk from inside the browser — no PC needed:

- 🔗 Google Drive, OneDrive, Dropbox, gofile links auto-rewrite to direct downloads
- 🌐 Links that need a browser open the built-in WebView overlay for a manual click-through
- 📊 Progress bar with cancel; writes to external drives on Xbox

### ⚙️ Settings & Logs
- 🎛️ Hierarchical settings menu: clear data, log level, background music, hide empty drives
- 🎚️ BGM controls: enable/disable, pick your own track, volume 10–100%
- 🫥 **Hide empty/unaccessible drives** (default ON) — system XVDs the container can't read never clutter the drive list
- 📜 Built-in log viewer with daily rotation (last 10 sessions)
- 🔍 Start menu with search, favorites, about — everything gamepad-driven

---

## 🎮 Controls

| Button | Action |
|--------|--------|
| 🕹️ **D-pad / Left Stick** | Navigate up/down |
| **D-pad Right / A** | Enter folder · Play file · Toggle play-pause |
| **D-pad Left / B** | Go back · Close fullscreen |
| **LB / RB** | Page up/down in browser · Next/prev track (audio) · Seek 5s (video) |
| **Y** | Context menu (rename, delete, create ZIP, extract, properties...) |
| **Y (hold)** | Add/remove favorite |
| **X** | Refresh current directory |
| **Right Analog Stick** | Scroll preview · Adjust volume (fullscreen) |
| **Select** | Cycle audio visualizer (media) · Toggle batch mode (browser) |
| **Select (hold)** | Visualizer picker (media) |
| **Start** | Start menu: settings, logs, favorites, search, about |

---

## 📸 Screenshots

<details>
<summary>📸 All screenshots (54)</summary>

</details>

---

## 🚀 Getting Started

### Prerequisites

- **Xbox One** or **Xbox Series X|S** with **Developer Mode** enabled

That's it. No PC, no Visual Studio, no special tools needed.

### Install

1. Enable **Developer Mode** on your Xbox (install "Dev Home" from Microsoft Store).
2. Download the `.appxbundle` package from [Releases](https://github.com/marcelofrau/x-files-uwp/releases).
3. Open **Xbox Device Portal** from any device on your network:
 ```
 https://<XBOX-IP>:11443
 ```
4. Go to **Apps** → **Add** → select the package → **Install**.

See [DEPLOY-XBOX.md](docs/DEPLOY-XBOX.md) for detailed steps.

---

## 🏗️ Tech Highlights

| Feature | How |
|---------|-----|
| ⚡ Fast directory scanning | P/Invoke `FindFirstFileExFromAppW` + `GetLogicalDrives` — bypasses slow `StorageFolder` APIs |
| 🎮 Gamepad input | Native `Windows.Gaming.Input.Gamepad` polling with edge detection and repeat |
| 🎨 Custom theme | Zero Fluent Design chrome — every control uses custom `ControlTemplate` |
| 🎵 Audio playback | AudioGraph with stream fallback for USB drives + real-time FFT spectrum |
| 🕹️ Chiptune player | game-music-emu + libopenmpt + aosdk PSF + lazyusf USF — 43+ formats, plays-while-renders |
| ✨ Audio visualizers | 31 Win2D/HLSL visualizers (VU meter, waveform, plasma, starfield...) |
| 🎶 Background music | Own AudioGraph; bundled SPC stream-rendered to WAV on first boot |
| 📦 Archive support | SharpCompress for ZIP/7Z/RAR — browse without extracting |
| 📝 Syntax highlighting | Inlined highlight.js for 40+ languages (Aco theme) |
| 🧠 Metadata guesser | ID3 + filename + MusicBrainz/Deezer enrichment, SQLite cache with cover art |
| 📖 PDF viewer | Windows.Data.Pdf — page thumbnails + fullscreen |
| 🎮 ROM preview | Header parsing for 35+ extensions, system icons |
| 🌐 Network access | `INetworkFileSystemProvider` layer — SMB/FTP/FTPS/SFTP/WebDAV, streaming preview, remote ops |
| 📑 File properties | Pure helpers — `DirectoryStatsCalculator`, `MediaMetadataProbe` (MP3/FLAC/WAV/MP4/PDF/images) |
| 🔗 QR sharing | gofile.io upload + ZXing QR generation |
| 📥 URL downloads | HttpClient + provider rewrites (Drive/OneDrive/Dropbox) + WebView fallback |
| 📋 Logging | Serilog — every operation, input event, and exception logged with daily rotation |

## 🏗️ Architecture at a glance

```mermaid
flowchart LR
 subgraph Input
 I[Gamepad / Keyboard] --> IR[InputRouter]
 end
 IR --> NAV[Navigation ColumnNavigator]
 NAV --> FS[FileSystem DirectoryScanner / ArchiveBrowser]
 FS --> PV[Preview FilePreviewService]
 PV --> AP[Audio Player AudioLevelService]
 AP --> RETRO[Chiptune Engine RetroAudioPlayer]
 RETRO --> RA[RetroAudio.dll GME · openmpt · aosdk · lazyusf]
 AP --> VIZ[Visualizers Win2D · HLSL]
 FS --> BGM[Background Music BackgroundMusicService]
 BGM --> RETRO
 PV --> MEDIA[Media Audio / Video / PDF / ROM / Text]
 FS --> SRV[Services Share QR · URL Download · Metadata]
```

---

## 📚 Documentation

| Doc | What it covers |
|-----|----------------|
| [SPEC.md](docs/SPEC.md) | Functional spec, MVP scope, done criteria |
| [ARCHITECTURE.md](docs/ARCHITECTURE.md) | Layered architecture, data flow, column model |
| [GAMEPAD.md](docs/GAMEPAD.md) | Button mapping, INavigable contract |
| [FILEBROWSER.md](docs/FILEBROWSER.md) | FileEntry model, DirectoryScanner, sorting |
| [ARCHIVES.md](docs/ARCHIVES.md) | ZIP/7Z/RAR via SharpCompress |
| [AUDIO-VISUALIZATION.md](docs/AUDIO-VISUALIZATION.md) | VU meter architecture, AudioGraph, FFT |
| [AUDIO-VISUALIZERS.md](docs/AUDIO-VISUALIZERS.md) | 31 Win2D visualizers, registry, shader pipeline |
| [FILETYPE-ICONS.md](docs/FILETYPE-ICONS.md) | File-type icon mapping |
| [ROM-FORMATS.md](docs/ROM-FORMATS.md) | ROM header parsing, systems/extensions |
| [FILE-SHARING-QR.md](docs/FILE-SHARING-QR.md) | QR file sharing via gofile.io |
| [network-files/](docs/network-files/) | Network access (SMB/FTP/SFTP/WebDAV) — plan, spec, architecture |
| [SETTINGS-EXPANSION.md](docs/SETTINGS-EXPANSION.md) | Planned settings expansion (theme, deadzones) |
| [UI-THEMING.md](docs/UI-THEMING.md) | ControlTemplate conventions |
| [ROADMAP.md](docs/ROADMAP.md) | Implementation status + remaining backlog |
| [DECISIONS.md](docs/DECISIONS.md) | ADRs — why XAML, why SharpCompress, etc. |
| [LOGGING.md](docs/LOGGING.md) | Log levels, debug flags, architecture, conventions |
| [RELEASE.md](docs/RELEASE.md) | Release process, CI/CD, versioning |
| [DEPLOY-XBOX.md](docs/DEPLOY-XBOX.md) | Developer Mode, Device Portal, sideload steps |

### 📖 End-user guides (GitHub Wiki)

Non-technical, gamepad-first tutorials for everyday use:

| Guide | What it covers |
|-------|----------------|
| [How to install X-Files](https://github.com/marcelofrau/x-files-uwp/wiki/Installing-X-Files) | Developer Mode, Device Portal, sideload |
| [Sharing files with your phone](https://github.com/marcelofrau/x-files-uwp/wiki/Sharing-files-with-your-phone) | QR share via gofile.io |
| [Downloading files from the internet](https://github.com/marcelofrau/x-files-uwp/wiki/Downloading-files) | URL download, Drive/OneDrive/Dropbox links |
| [Editing text files](https://github.com/marcelofrau/x-files-uwp/wiki/Editing-text-files) | Built-in editor, save, encodings |
| [Listening to music](https://github.com/marcelofrau/x-files-uwp/wiki/Listening-to-music) | MP3/FLAC + chiptunes, visualizers |
| [Background music](https://github.com/marcelofrau/x-files-uwp/wiki/Background-music) | BGM toggle, custom track, volume |
| [Watching videos](https://github.com/marcelofrau/x-files-uwp/wiki/Watching-videos) | Subtitles, audio tracks, fullscreen |
| [Browsing your files](https://github.com/marcelofrau/x-files-uwp/wiki/Browsing-your-files) | Columns, favorites, search, batch ops |

---

## 🤝 Community

Thanks to the **emulationrevival** community for the support and encouragement:

- **alouisious** — feature ideas and active collaboration on X-Files
- **MewLew**, **Caorthann**, **DanP142** — keeping the homebrew community alive and thriving

---

## 📄 License

[GPL-3.0](LICENSE) — free software; you can redistribute it and/or modify it under the
terms of the GNU General Public License as published by the Free Software Foundation,
either version 3 of the License, or (at your option) any later version.

---

Made with ❤️ for the Xbox homebrew community

x-files-uwp

오너의 다른 레포

파일 탐색기

# CDN으로 사용하기

Was this content helpful?

Recent Feedback

x-files-uwp

오너의 다른 레포

파일 탐색기

# CDN으로 사용하기

Was this content helpful?

Recent Feedback

Download README