How to Download and View Unity Logs from Your Game

Alon Farchy

Jun 24, 2024

Share this

Copied!

When developing your game, you’ll often use Unity’s Debug class to log messages. Sometimes, you’ll need to download and view Unity log files after your users hit an issue to figure out what happened.

This article explains where Unity stores log files on every platform and introduces a free tool you can use to view those logs quickly.

Alternatively, if you need to view a live log stream from your game, see my other article: How to stream Unity logs from your game.

Quick Answer: Unity log file locations

If you only need the paths, jump to your platform below. The log file is usually named Player.log for standalone builds.

Table of Contents

• Quick Answer: Unity log file locations
• Windows (Win32)
• Windows (UWP)
• Mac
• Linux
• iOS
• Android
• WebGL
• Custom Log File Path
• How to view Unity log files
• FAQ: Unity log files

Where does Unity store log files?

See the official documentation on Unity log files.

Windows (Win32)

%USERPROFILE%\AppData\LocalLow\CompanyName\ProductName\Player.log

Windows (UWP)

%USERPROFILE%\AppDataLocal\Packages\ProductName\TempState\Unity\Player.log

Mac

~/Library/Logs/CompanyName/ProductName/Player.log

Linux

~/.config/unity3d/CompanyName/ProductName/Player.log

iOS

iOS builds don’t save a log file to disk. Instead, you can use Proxima Inspector to get the log stream and then save that to a file.

• How to get a log stream with Proxima Inspector

Android

Android builds don’t save a log file to disk. Instead, you can use adb or Proxima Inspector to get the log stream and then save that to a file.

• How to get a log stream using adb
• How to get a log stream with Proxima Inspector

WebGL

WebGL builds don’t save a log file to disk. However, you can easily view the logs in the browser’s Developer Tools (F12). Read more details, as well as how to get browser logs from a mobile device here.

Custom Log File Path

For Windows, Mac, and Linux you can specify the path where Unity will write the log by passing a command line argument to the game. This can let you append a timestamp and avoid overwriting old log files.

> MyGame.exe -logFile path/to/my/logfile.log

How to view Unity log files

Now that you have the log file, you can open it in any text editor, but you might notice it’s quite hard to read through, especially if you have stack traces enabled.

Fortunately, we’ve built a solution! Proxima Log Viewer is a free online tool you can use to view your logs just like the Unity editor.

Just go to https://app.unityproxima.com/logs, click Load, and select your log file.

Proxima Log Viewer provides the same collapsing, searching, and filtering capabilities that the Unity Editor provides, and you can use it on any log file in any browser without installing Unity.

On top of that, if you enabled stack traces in your player build (see how to do that here), then you’ll also be able to see if the logged message was an error or warning.

FAQ: Unity log files

Why don’t I see a log file on iOS or Android? Those platforms don’t write a persistent Player.log file by default. Use a live log stream (adb, Unity Editor Console, or Proxima Inspector) and save it if needed.

Where is the Editor log? The Unity Editor log is stored separately from player logs. See the official Unity log file documentation for exact Editor log paths: https://docs.unity3d.com/Manual/LogFiles.html

Can I rename the log file? Yes. Use the -logFile argument to set a custom file name or path. This is great for adding timestamps.

My log file is empty — why? Some crashes happen before Unity initializes logging. In that case, try enabling Development Build, or capture logs from a live stream.

I hope this helped you in your game development!

Further Reading

• How to Stream Unity Logs from Your Game
• Git and Unity: A Comprehensive Guide to Version Control for Game Devs
• Automating Unity Builds with GitHub Actions