NeuralScreen README

The project's README from github.com/perseval-BLR/NeuralScreen. As one markdown file: README.md.

NeuralScreen

NVIDIA's DLSS 5 neural renderer, applied to your whole Windows desktop in real time. Everything on screen — games, video, photos — goes through the same neural network that DLSS 5 games use, and comes back sharper.

Menu, light theme Menu, dark theme

Everything lives in one menu inside the overlay. The Before / after wipe slider splits the screen down the middle so you can see what the effect is actually doing.

What you need

Trying RTX 20

Turing is below the minimum architecture - no runtime build makes the neural pass run on it (0xBAD00001, FeatureNotSupported). The program will start and the menu works; the picture is not processed. No workaround exists.

Install

  1. Download the archive from Releases and unpack it anywhere. Everything is inside — including NVIDIA's nvngx_dlssnr.dll (165 MB, too big for GitHub to keep in the repository, so it ships in the archive instead).
  2. Run NeuralScreen.exe.

Windows will probably warn you about an unknown publisher the first time — the program is not signed with a paid certificate. Click More info → Run anyway. If you would rather not, NeuralScreen.vbs next to it does the same thing.

There is no installer and nothing is written outside the folder. To remove it, delete the folder.

Do not use it in competitive online games. A process named nvngx.dll plus a fullscreen overlay is exactly what anti-cheat systems look for.

Using it

The program sits in the tray (with a taskbar button) and draws over your desktop. Press Num2 for the menu. The hotkeys live on the numpad, so Num Lock has to be on - with it off those keys send Insert/End/arrows instead and nothing happens.

Key What it does
Num2 open / close the menu
Num1 neural rendering on / off
Num3 screenshot
Num0 start / stop recording, with sound
Num4 / Num6 processing resolution down / up
Num5 process one window instead of the whole screen
Ctrl+Alt+Q quit

Every key can be reassigned in the menu, under the sliders icon.

While the menu is open it takes the mouse and keyboard, so it works on top of a game. Closed, clicks go straight through it as if it were not there.

Startup and mode switches do not flash: the overlay appears with the first real frame, a brief blur-with-spinner covers the pipeline rebuild.

Whole screen or one window

NeuralScreen renders the whole screen by default. To process one window instead (a game, a browser): point at it, press Num5 or pick Select window... in the menu. The overlay follows the window. Back to the whole screen: Num5 again or Fullscreen in the menu. Minimising the window pauses processing.

The menu

Window list Settings page

The dot next to your graphics card is green when neural rendering is actually running on it, red when it is not.

The settings worth touching:

The interface speaks 12 languages - English, Russian, French, German, Spanish, Italian, Portuguese, Polish, Ukrainian, Chinese, Japanese and Korean. Pick one under the sliders icon (Language). The menu, the HUD and the alerts all follow.

Everything else — which monitor, whether the menu opens on launch, starting with Windows, key assignments — is behind the sliders icon.

Recording and screenshots

Num0 records what you see, with system sound, into an MP4 in recordings. Num3 saves a screenshot. The menu shows up in both if open - on purpose. The recording audio passes through a soft limiter, so a loud system mix cannot clip the track into distortion.

Record the processed picture externally:

If something is not working

Nothing appears after launch. Check NeuralScreen.log next to the program; the most common cause is a missing native\nvngx_dlssnr.dll.

The overlay is invisible in a game. True fullscreen cannot have anything drawn over it — a Windows rule. Switch the game to borderless or windowed fullscreen.

The menu pointer is missing or frozen. A fullscreen game hides the system cursor; the overlay only shows the system cursor. Borderless fixes it.

The numpad hotkeys do nothing. They need Num Lock to be on. With Num Lock off the numpad sends Insert/End/arrows and the keys simply do not exist.

The picture is soft. Put Resolution the network runs at back to the top of its slider.

A key does nothing. Something else claimed it; reassign it in the menu under the sliders icon.

The menu is slow in a heavy game. At 4K the pipeline can take up to a second per frame; a press may feel lost. The picture is the priority.

Known limitations

Under the hood — how it works, what was measured and why: docs/TECHNICAL.md. Русская версия: README.ru.md.

License

The code here is MIT. NVIDIA's nvngx_dlssnr.dll is the leaked 310.8.0 runtime (sm_75/86/89/120 kernels, RTX 20-50). Included as-is, no guarantees; research-only.

NeuralScreen (perseval-BLR/NeuralScreen)

Searching Database…

1.1K ·GitHub
NeuralScreen
Что это такое?NeuralScreen применяет нейрорендерер NVIDIA DLSS 5 ко всему рабочему столу Windows в реальном времени, так что игры, видео и фото становятся резче благодаря той же сети, которую DLSS 5 использует в играх, а не просто апскейлятся в одном приложении.
Это Python-скрипт, который я запускаю, или упакованное приложение?Это упакованный самостоятельный .exe, который сидит в трее и рисует оверлей; хотя он написан на Python, релизный архив несёт собственный рантайм Python, так что ничего не нужно устанавливать отдельно.
Как его запустить?Скачайте архив со страницы Releases, распакуйте в любое место и запустите NeuralScreen.exe (или приложенный .vbs-лаунчер). Установщика нет, и за пределами папки ничего не записывается, так что удаление — это просто удаление папки.
Какое железо нужно — любая карта RTX или конкретное поколение?Нужны Windows 11 и карта NVIDIA RTX. RTX 50 и 40 работают нативно, RTX 30 работает через восстановленный универсальный рантайм, а RTX 20 (Turing) вообще не может выполнить нейропроход — она ниже минимально поддерживаемой архитектуры.
Работает ли это поверх полноэкранных игр?Нет — из-за ограничения Windows поверх настоящего полноэкранного режима ничего нельзя нарисовать, поэтому нужен безрамочный или оконный полноэкранный режим. HDR-дисплеи тоже не поддерживаются, а разрешение обработки ограничено 2560x1440 даже на 4K-экранах.
В чём ситуация с лицензией?Собственный код NeuralScreen — MIT, но он содержит nvngxdlssnr.dll от NVIDIA — утёкший рантайм, включённый как есть, без каких-либо гарантий, только для исследовательских целей.
Безопасно ли использовать это в онлайн-мультиплеерных играх?Нет — README прямо предупреждает об этом, поскольку процесс с именем nvngx.dll плюс оверлей в полноэкранном стиле — это именно то, что ищут античит-системы.
Можно ли записывать улучшенную картинку для стриминга?Да, запустите с переменной окружения NSSPOUT=1, чтобы публиковать обработанный вывод как разделяемую текстуру Spout2 и захватывать её в OBS бесплатным плагином Spout2; это работает и в полноэкранном режиме.
Сколько языков поддерживает оверлей?Двенадцать: английский, русский, французский, немецкий, испанский, итальянский, португальский, польский, украинский, китайский, японский и корейский — выбираются в меню настроек.
Можно включить его для одного окна вместо всего экрана?Да, наведитесь на окно и нажмите Num5 (или выберите Select window в меню), чтобы оверлей следовал только за этим окном; нажмите Num5 снова, чтобы вернуться к обработке всего экрана.
What are similar projects?dlss5-visual-enhancer, DLSS5-Autopilot, video2dlssnr, DLSS5oneclick, OptiScaler-DLSSNR-PreSR-Multipass, DLSS-5-MANAGER, 1-Click-DLSS5, dlss5-bridge
Which topics is it in?dlss5, image-upscaling, overlay, frame-generation, rtx, dlss, recording, neural-rendering, screen-recording, screen-capture, upscaling, localization
Creator
perseval-BLR
Size
18.3 MB
Stars
1.1K
Updated
CommitOct 20Releasev2.6.2Oct 20
Age
1mo
Commits · 90 Days