whatisgithub

What is phantomfs?

alloysecuregroup/phantomfs — explained in plain English

Analysis updated 2026-05-18

61C#Audience · ops devopsComplexity · 3/5LicenseSetup · moderate

In one sentence

A Windows honeypot that shows fake sensitive files in a virtual folder and alerts instantly the moment anyone opens one.

Mindmap

mindmap
  root((PhantomFS))
    What it does
      Fake decoy files
      Instant alerts
      Windows honeypot
    Tech stack
      C sharp
      ProjFS
      NET Framework
    Use cases
      Insider threat detection
      Network intrusion alerts
      Decoy credentials
    Audience
      Security teams
      IT admins

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Detect an intruder or insider browsing files they should not have access to on a Windows file share.

USE CASE 2

Set up early warning alerts for lateral movement inside a corporate network.

USE CASE 3

Add decoy credentials and financial documents to a monitored folder as a tripwire.

USE CASE 4

Get a Windows Event Log entry and desktop notification the instant a honeypot file is opened.

What is it built with?

C#.NET FrameworkProjFSWindows

How does it compare?

alloysecuregroup/phantomfsrichardchanjr90-cpu/ddd-by-examplenuskey8/dotwasm
Stars616162
LanguageC#C#C#
Setup difficultymoderatemoderatemoderate
Complexity3/54/54/5
Audienceops devopsdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires enabling the Windows Projected File System feature and running as Administrator.

Free to use, modify, and distribute for any purpose, including commercial use, as long as the license notice is kept.

So what is it?

PhantomFS is a Windows tool that creates a fake folder full of convincing but fake files, things like financial reports, SSH keys, and spreadsheets of employee salaries, to catch anyone who should not be looking through them. It uses a Windows feature called the Projected File System to make these files appear real in File Explorer, even though nothing is actually written to disk until someone opens one. The idea is that a legitimate user has no reason to open files they did not create, so any attempt to read one is treated as a strong signal that something is wrong, whether that is an outside attacker who broke in or an employee looking where they should not be. The moment a decoy file is opened, PhantomFS writes an entry to the Windows Event Log, sends a desktop notification, and records which process touched the file along with the exact time. If the file was reached over a shared network folder, it also tries to capture the username and address of the remote computer that opened it. After a file has been opened and its content generated, PhantomFS can automatically delete that copy after a configurable delay, so it reverts back to being a placeholder and will trigger an alert again the next time someone opens it. Setting it up requires Windows 10 or later, the .NET Framework, and turning on the Projected File System feature, plus running as an administrator. Configuration lives in a single settings file where you can turn logging and notifications on or off, adjust how often alerts can fire for the same file, and add your own list of decoy filenames and realistic file sizes. There is also a web based profile builder for generating different configuration files for different deployment scenarios. PhantomFS is released under the MIT license.

Copy-paste prompts

Prompt 1
Walk me through enabling the Windows Projected File System feature so PhantomFS can run.
Prompt 2
Help me write a PhantomFS config with a custom set of decoy filenames for a finance team share.
Prompt 3
Explain what each event ID in PhantomFS's Windows Event Log entries means.
Prompt 4
Show me how to reduce PhantomFS toast alert spam using the cooldown setting.

Frequently asked questions

What is phantomfs?

A Windows honeypot that shows fake sensitive files in a virtual folder and alerts instantly the moment anyone opens one.

What language is phantomfs written in?

Mainly C#. The stack also includes C#, .NET Framework, ProjFS.

What license does phantomfs use?

Free to use, modify, and distribute for any purpose, including commercial use, as long as the license notice is kept.

How hard is phantomfs to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is phantomfs for?

Mainly ops devops.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.