https://github.com/SlushyRH/Unity-External-Console

A simple script that shows an external CMD Console in runtime that displays all Unity log messages.
https://github.com/SlushyRH/Unity-External-Console

console csharp game-development gamedev mit-license script slushyrh srh unity unity-scripts unity2d unity3d

Last synced: 3 months ago
JSON representation

A simple script that shows an external CMD Console in runtime that displays all Unity log messages.

• Host: GitHub
• URL: https://github.com/SlushyRH/Unity-External-Console
• Owner: SlushyRH
• License: mit
• Created: 2025-05-03T05:05:51.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2026-02-02T14:30:45.000Z (5 months ago)
• Last Synced: 2026-02-03T01:59:57.509Z (5 months ago)
• Topics: console, csharp, game-development, gamedev, mit-license, script, slushyrh, srh, unity, unity-scripts, unity2d, unity3d
• Language: C#
• Homepage:
• Size: 12.2 MB
• Stars: 40
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
Unity External Console

A lightweight external CMD console for Unity that mirrors the Debug Logging in real-time. It features automatic injection and

a settings menu under Tools/SRH/External Console Settings. Perfect for off-screen debugging in multi-monitor environments. 




> [!WARNING]

> The console will only open in a Windows OS build. If it is not, then the console simply won't show, but your game will run as normal.

# How To Use

1. Install Unity External Console by adding package:

    1. via Git URL: `https://github.com/SlushyRH/Unity-External-Console.git`

    2. via OpenUPM: `com.slushyrh.unityexternalconsole`

2. Done! You can optionally edit the settings at `Tools/SRH/External Console Settings`

> [!NOTE]

> If at any point you want to disable the External Console window, you can either set the

> `Target Build` to NONE, or add `DISABLE_EXTERN_CMD` to the Scripting Define Symbols.

# Settings



You can change the settings under `Tools/SRH/External Console Settings` in the Unity Editor, or by accessing the

settings through `ConsoleWindow.Settings` during runtime.

- **Console Window Name** controls the name of the console window. If empty, it will display the path to the game's exe

- **Target Build** controls when the console is allowed based on the type of build:

    - **None** means it will never show

    - **Development** means it will only show on development builds (This is the default)

    - **Release** means it will only show on release builds

    - **Everything** means it will show in both development and standard builds

- **Stack Trace Visibility** controls whether the stack trace will be logged to the console.

  - Stack Trace will only be visible in Error & Exception messages unless in a Development build in which case all Stack Traces will be visible.

- **Include Log Type** will add the log type in front of the message:

    - [Info] Log Message Here

    - [Error] Log Message Here

- **Include Timestamp** will add the time of the log in front of the message:

    - [16:24:14] Log Message Here

- **Timestamp Format** will allow you to switch the format of the timestamp between 12 and 24 hour formatting:

    - [4:24:14 PM] Log Message Here

    - OR

    - [16:24:14] Log Message Here

- **Log Colours** will allow you to control what colour each log appears as in the console.

  


If both Include Log Type and Include Timestamp are on. Then the LogType will come first and will be displayed in the console like this: [LogType] [Timestamp] Log Messager Here