• Ubuntu 18.04
  • Pycharm 2019.2 professional edition
  • Python 3.6.8

I have followed this link to create a pycharm remote debugger but I have encountered an error related to remote_debugger.py

Blender add-on configuration:

enter image description here

Pycharm state:

enter image description here

Blender error:

enter image description here

It's nearly impossible to write a complex program in Blender without debugging options. Can you please help me solve this problem? I also think this should be an important feature request for the next release - an easy way to debug the code with 3rd party program.

Thank you all in advance.


1 Answer 1


Below you find the updated remote_debugger.py which runs in Blender 2.80.

  1. Install the add-on
  2. Set the paths to the pydevd.py and pydevd-pycharm.egg (don't forget to save the preferences)
  3. Configure and start the remote debug server in PyCharm
  4. Search for the Connect to remote PyCharm debugger in the operator search using F3 or Edit > Operator Search

This works only with PyCharm Professional, the Community Edition is missing the remote debug feature.

Remote debugging support.
This addon allows you to use a remote Python debugger with PyCharm, PyDev and
possibly other IDEs. As it is, without modification, it only supports PyCharm,
but it may work by pointing it at a similar egg file shipped with PyDev.
Before using, point the addon to your pydevd-pycharm.egg file in the
addon preferences screen.
For more information on how to use this addon, please read my article at

bl_info = {
    'name': 'Remote debugger',
    'author': 'Sybren A. Stüvel and Robert Gützkow',
    'version': (0, 4),
    'blender': (2, 80, 0),
    'location': 'Press F3, search for "debugger"',
    'category': 'Development',

import bpy
import os.path
from bpy.types import AddonPreferences
from bpy.props import StringProperty

class DebuggerAddonPreferences(AddonPreferences):
    # this must match the addon name, use '__package__'
    # when defining this in a submodule of a python package.
    bl_idname = __name__

    eggpath: StringProperty(
        name='Path of the PyCharm egg file',
        description='Make sure you select the py3k egg',

    pydevpath: StringProperty(
        name='Path of the PyDev pydevd.py file',

    def draw(self, context):
        layout = self.layout
        layout.prop(self, 'pydevpath')
        layout.prop(self, 'eggpath')
        layout.label(text='Make sure you select the egg for Python 3.x: pycharm-debug-py3k.egg ')

class DEBUG_OT_connect_debugger_pycharm(bpy.types.Operator):
    bl_idname = 'debug.connect_debugger_pycharm'
    bl_label = 'Connect to remote PyCharm debugger'
    bl_description = 'Connects to a PyCharm debugger on localhost:1090'

    def execute(self, context):
        import sys

        user_preferences = context.preferences
        addon_prefs = user_preferences.addons[__name__].preferences

        eggpath = os.path.abspath(addon_prefs.eggpath)

        if not os.path.exists(eggpath):
            self.report({'ERROR'}, 'Unable to find debug egg at %r. Configure the addon properties '
                                   'in the User Preferences menu.' % eggpath)
            return {'CANCELLED'}

        if not any('pycharm-debug' in p for p in sys.path):

        import pydevd_pycharm
        pydevd_pycharm.settrace('localhost', port=1090, stdoutToServer=True, stderrToServer=True,

        return {'FINISHED'}

class DEBUG_OT_connect_debugger_pydev(bpy.types.Operator):
    bl_idname = 'debug.connect_debugger_pydev'
    bl_label = 'Connect to remote PyDev debugger'
    bl_description = 'Connects to a PyDev debugger on localhost:5678'

    def execute(self, context):
        import sys

        user_preferences = context.preferences
        addon_prefs = user_preferences.addons[__name__].preferences

        pydevpath = os.path.abspath(addon_prefs.pydevpath)

        if not os.path.exists(pydevpath):
            self.report({'ERROR'}, 'Unable to find pydevd.py at %r. Configure the addon properties '
                                   'in the User Preferences menu.' % pydevpath)
            return {'CANCELLED'}

        dirname = os.path.dirname(pydevpath)
        basename = os.path.basename(dirname)
        if not any(basename in p for p in sys.path):

        import pydevd
        pydevd.settrace('localhost', port=5678, stdoutToServer=True, stderrToServer=True,

        return {'FINISHED'}

def register():

def unregister():

if __name__ == '__main__':
  • $\begingroup$ If you have the time, please open up a pull request: github.com/sybrenstuvel/random-blender-addons/pulls Otherwise others will do the same again or this nice snipped (your work) is lost in question land. $\endgroup$
    – brockmann
    Sep 17, 2019 at 20:04
  • $\begingroup$ @brockmann Sure I will. Not today though, likely tomorrow. $\endgroup$
    – Robert Gützkow
    Sep 17, 2019 at 20:04
  • $\begingroup$ @brockmann Seems like others were a bit faster. There are already two pull requests. $\endgroup$
    – Robert Gützkow
    Sep 17, 2019 at 20:09
  • $\begingroup$ Huh, your code is way nicer for sure, go for it @rjg :D $\endgroup$
    – brockmann
    Sep 17, 2019 at 20:14
  • $\begingroup$ @rjg thank you for the code! I managed to establish the connection between pycharm and blender but still got a problem. In the guide link from my first message, it said that the debugger should stop on pydevd.settrace(…) call but it doesn't. Can you please guide me on how can I debug my project and see the outcome on blender via pycharm? (The connection is established) $\endgroup$
    – AvivSham
    Sep 18, 2019 at 10:33

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .