Items to check when Editor / Viewer does not start normally

(Updated on 2021/03/11)

If the Editor/Viewer does not start, check the situation according to the following steps.

This page has moved to Live2D Help and has been updated.
For the latest information, see the following pages in Live2D Help.
""Cubism Editor / Viewer does not start normally (Windows) --Live2D Help』\
""Cubism Editor / Viewer does not start normally (Mac) --Live2D Help』\

Step 1

Confirm operating environment

"Operating environmentCheck the contents of the page.
Let's check if all the requirements are met.


Confirmation of installation location

Let's make sure that it is correctly installed in the following location.

C: Program Files \ Live2D Cubism XX

Check version

update historyCheck and currently installedCubismLet's check if the version of is the latest.
update history

If it is not the latest version, update it.


Step 2

Confirmation of GPU (graphic board)

Depending on your preferences, it may be set to use the onboard (built-in graphics processor).
Check the graphics processor settings.

This timeNVIDIAofFor GeForce graphics processorWill be introduced as an example.


no.  Description reference image
Right-click on the desktop and click "NVIDIA Control Panel" in the red frame of the reference image on the right.
Check the location of the red frame in the reference image on the right on the NVIDIA control panel.
For those who are "automatically selected", changing the setting to "High Performance NVIDIA Processor" will switch the graphics processor used to GeForce.
(* The setting method may differ depending on your environment and settings. For details, please contact the vendor of your graphic processor.)


"OpenGL initialization failed. Please check if your computer meets the operating environment."

Message may be displayed and startup may fail.
If you see this message on a machine that meets your operating environment
The cause may be that the graphics driver is out of date, so please update to the latest version.


Confirm whether it is running with administrator's privilege

Let's check if your current PC is running as "administrator authority".


Check whether the login user's account name contains spaces

In Windows, if the logged-in user's account name contains spaces or special symbols such as spaces,
There may be a problem with the behavior of Editor / Viewer.

Let's check if there is a problem with the account name of the logged-in user.


Confirm that OpenGL is 3.3 or higher

There seems to be a case that OpenGL switches when upgrading OS.
Let's check whether it meets the operating environment.


Step 3

Check if it can be started from the bat file

Check if it can be started normally from the following bat file.
If you can operate normally from the bat file, the contents of the application will not change, so please use it as it is.

Cubism For Editor:
"CubismEditorX.bat" and "CubismEditorX_d3d.bat" are bat files
Cubism For Viewer:
"CubismViewerX.bat" and "CubismViewerX_d3d.bat" are bat files



Step 4

If you do not see any improvement after checking up to step 3, there may be something wrong.
If you report a bug to the community and send us a "log" at the same time,
We will be able to respond smoothly, so we would appreciate it if you could try the following methods.


When log can be acquired

If the Editor/Viewer can be started, even temporarily, in some way, the following procedure can be used to obtain logs.

When a malfunction occurs, an error is displayed in the log palette with "Red".
Follow the steps below to obtain the "log.txt" file.

Click “Help” in the File menu → Click “Open log file” → All “log.txt”

In the community, if you can attach "log.txt" at the same time as reporting the problem, smooth correspondence is possible.


When log can not be acquired

If the Editor itself can not be started and log can not be acquired, trouble information is acquired from the command prompt.
Please try the following procedure.

  1. Click Start Menu → Windows System Tools → Command Prompt
  2. Go to the command prompt "cd" C: \ Program Files \ Live2D Cubism XX "" Copy and paste in parentheses and Enter
    * Please replace XX with your version name.
  3. Copy and paste "CubismEditorX.bat" in parentheses to the command prompt and Enter
    * Replace X with your version name.
  4. Click on the top left icon of the title of the command prompt
  5. From the command prompt menu, click Edit ® Mark (or selection)
  6. Select all the contents outputted at the command prompt and copy and paste it into a text file


In the community, if you attach the contents obtained at the same time as reporting the defect as "text file"
Smooth correspondence is possible.


© 2010 --2022 Live2D Inc.