Documentation

User Guide

NSFW Manager v2.0.0 Last updated: June 2026 Report a Bug


1. What is NSFW Manager?

NSFW Manager is a privacy-first desktop application that scans, detects, classifies and quarantines sensitive media files stored directly on your computer — without ever uploading a single file to the internet.

Key Benefits

BenefitDetails
100% local processingAll AI detection runs on your machine. Nothing leaves your hard drive.
Multiple detection enginesChoose the engine matching your speed vs. accuracy needs.
Visual quarantine vaultReview flagged files before any action.
Light & dark modeA clean modern interface that respects your eyes.
One licence, one machineYour key is tied to your hardware for maximum security.

What it does NOT do

  • Does not upload files to any cloud service.
  • Does not collect telemetry or usage statistics.
  • Does not require internet to scan (only for licence validation).

2. System Requirements

ComponentMinimumRecommended
OSWindows 10 64-bitWindows 11 64-bit
RAM4 GB8 GB+
Disk500 MB free2 GB+ free
CPUDual-core 2 GHzQuad-core 3 GHz+
PythonNot required (bundled) — only for ifnude engine
InternetRequired for licence validation only
macOS / Linux: The application currently targets Windows. Cross-platform support is on the roadmap.

3. Installation

3.1 Download the installer

  1. Go to download.nsfwmanager.com and click Download Now the trial version.
  2. Save nsfwmanager-latest.msi and double-click to install.
  3. The application installs to C:\Program Files\NSFW Manager\ by default.

3.2 First launch

On first launch the app looks for a licence at %APPDATA%\NsfwManager\licence.lic. If none is found, a startup popup appears:

StatusWhat you seeWhat to do
TrialTrial version activeContinue — 20-file move limit applies
ExpiredLicence expiredRenew at login.nsfwmanager.com
RevokedLicence revokedContact support

4. Activating Your Licence

4.1 Purchase a licence

  1. Visit login.nsfwmanager.com and create an account.
  2. Go to Shop and choose your plan (Yearly or Lifetime).
  3. Complete the purchase — your key appears in the Dashboard.

4.2 Enter your licence in the app

  1. Open NSFW Manager.
  2. Go to Settings → Licence.
  3. Enter your email address and licence key, click Validate.

4.3 Machine binding

Each licence key is bound to one machine at first activation. To transfer: log in to the portal, click Unregister Machine, then activate on the new computer.

5. The Interface at a Glance

+----------------------------------------------------------+
|  NSFW Manager                       [_] [square] [X]   |
+----------------------------------------------------------+
|  [Select Folder] [Start Scan] [Stop]  Engine: [v]      |
+----------------------------------------------------------+
|  Progress: [========--------]  142 / 890 files          |
+----------------------------------------------------------+
|  Results                        |  Preview               |
|  !!  flagged_001.jpg  85%       |  Score: 85%            |
|  !!  flagged_002.png  92%       |  [Move] [Keep] [Del]   |
+----------------------------------------------------------+
|  Quarantine: 12 files  |  Log  |  Settings  |  Licence  |
+----------------------------------------------------------+
ControlDescription
Select FolderChoose the root directory to scan
Start ScanBegin recursive scan of all image files
StopInterrupt the current scan safely
Engine dropdownSwitch between detection engines
MoveSend flagged file to the chosen folder or quarantine
DeletePermanently delete the file (with confirmation)

6. Scanning Files

6.1 Starting a scan

  1. Click Select Folder and navigate to the folder to scan.
  2. Select your preferred detection engine from the dropdown.
  3. Click Start Scan.

The scan runs in a background thread — the interface stays responsive. You can preview files while scanning.

6.2 Supported file types

TypeExtensions
Images.jpg .jpeg .png .gif .bmp .webp .tiff
Video scanning is planned for a future release.

6.3 Scan depth

The scan is recursive — it processes all matching files in the selected folder and all sub-folders.

6.4 Move file limit (Trial)

In Trial mode you may move a maximum of 20 files per session to quarantine. Scanning and previewing are unlimited. Purchase a licence to remove this restriction.

7. Detection Engines

PersonalityInternal NameModel FileTypeBest for
🎯 Le Juste ParfaitPretty Good Enginemodel_int8Built-inDaily use — balanced accuracy
😎 Le Pas StresséRapid Enginemodel_fp16.onnxDownloadableSpeed — may allow borderline images
🔬 Le Scruteur à la LoupeSlow Enginemodel.onnxDownloadableMaximum accuracy — slower
🏴 Le RebelleOpen-Source EngineifnudeSelf-installGPLv3 users who prefer OSS

7.1 Built-in engine

The model_int8 model ships inside the installer. No download required. Great for everyday use.

7.2 Downloadable engines

Go to Settings → Engines and click Download. Models are saved to %APPDATA%\NsfwManager\models\.

7.3 ifnude (Open-Source Engine)

ifnude is licensed under GPLv3 and cannot be bundled. Install manually:

pip install ifnude

Python 3.8+ must be in your system PATH. It appears automatically in the engine dropdown once installed.

8. Quarantine & File Management

8.1 The quarantine folder

Default location: %APPDATA%\NsfwManager\Quarantine\. Change it in Settings → Quarantine → Change folder.

8.2 Moving files to quarantine

  1. Select the file(s) to quarantine.
  2. Click Move to Quarantine (or the Move button in the preview panel).
  3. The file is moved immediately. The original path is logged.
Trial users: Limited to 20 file moves per session.

8.3 Reviewing quarantined files

Click the Quarantine tab. From here you can:

  • Restore — Move the file back to its original location.
  • Delete permanently — Remove the file from disk (with confirmation).
  • Open folder — Reveal the file in Windows Explorer.

9. Settings & Configuration

9.1 General

SettingDescriptionDefault
ThemeLight or Dark modeDark
LanguageEnglish / FrenchSystem language

9.2 Detection

SettingDescriptionDefault
Default engineEngine used at startupPretty Good Engine
NSFW thresholdScore above which a file is flagged (0–100%)50%
Scan sub-foldersRecurse into sub-directoriesOn
Skip hidden filesIgnore files starting with .On

9.3 File Operations

SettingDescription
Quarantine folderPath where flagged files are moved
Confirm before deleteShow confirmation before permanent deletion
Log file operationsKeep a history of all moves and deletes

10. Licence Management Portal

The licence portal at login.nsfwmanager.com lets you:

  • View all your active licences
  • See plan type (Yearly / Lifetime), status (Active / Expired), and expiry date
  • See which machine each licence is bound to
  • Unregister a machine to transfer the licence

Renewing a Yearly licence

  1. Log in to the portal.
  2. Find the expired licence and click Renew Now.
  3. Complete payment, then re-validate in the app.

Transferring to a new machine

  1. Log in to the portal.
  2. Click Unregister Machine next to your licence.
  3. Activate on your new computer via Settings → Licence.

11. Trial vs Paid Licence

FeatureTrialYearlyLifetime
Scan unlimited files
All 3 built-in engines
Open-source engine (ifnude)
Light & dark mode
Move file limit20 / sessionUnlimitedUnlimited
Command-line interface
Auto-sorting rules
API access for local scripts
Priority support24h response
Commercial distribution licence

12. Privacy & Data Handling

What stays on your machine (always)

  • All image files you scan
  • All detection results and scores
  • The quarantine folder and its contents
  • Log files and your licence file
  • Downloaded model files

What contacts the internet

ActionEndpointData sentNOT sent
Licence validationapi.nsfwmanager.comEmail, key, machine hashAny file content
Licence renewalapi.nsfwmanager.comEmail, licence keyAny file content

What we never collect

  • Image or video files
  • File names or paths from your computer
  • Scan results or detection scores
  • Any personal data beyond your account email

13. Troubleshooting

The app will not start

  1. Ensure you are on Windows 10/11 64-bit.
  2. Try running the installer again as Administrator.
  3. Check Windows Event Viewer for errors.

Licence says invalid after purchase

  1. Wait 2–3 minutes after purchase.
  2. Use the exact email you registered with.
  3. Copy-paste the licence key — do not retype it.
  4. Check your internet connection to api.nsfwmanager.com.
  5. If the problem persists, contact info@nsfwmanager.com.

Machine mismatch error

Your licence is already bound to a different computer. Log in to the portal, click Unregister Machine, then validate again.

Rapid or Slow engine not available

Go to Settings → Engines and click Download. You need ~165–330 MB free.

ifnude does not appear

Install it manually: pip install ifnude. Python 3.8+ must be in your system PATH.

Scan is very slow

  • Switch to Le Pas Stressé (Rapid Engine).
  • Close other CPU-intensive applications.
  • Scan a specific sub-folder instead of your entire drive.

A file was moved by mistake

Go to the Quarantine tab and click Restore. It returns to its original location.

14. Open-Source Notices

ComponentLicenceNotes
ONNX NSFW ModelsApache 2.0Redistributed unchanged
PillowHPNDPython imaging library
send2trashBSD 3-ClauseSafe file deletion to trash
onnxruntimeMITAI inference runtime (Microsoft)
numpyBSD 3-ClauseNumerical processing
Python & tkinterPSF License v2Language & UI framework

Full licence texts are available in the app via Help → Open-Source Notices, in the installation folder under licenses\, and on the Legal Disclaimer page.