206

Long story short: pythonw.exe does nothing, python.exe accepts nothing (which one should I use?)

test.py:

print "a"

CMD window:

C:\path>pythonw.exe test.py
<BLANK LINE>
C:\path>

C:\path>python.exe test.py
  File "C:\path\test.py", line 7
    print "a"
            ^
SyntaxError: invalid syntax

C:\path>

Please tell me what I'm doing terrible wrong.

2
  • 22
    unfortunately this intermixes the two aspects python vs pythonw (generally the more interesting aspect) and some basic syntax change from python2 to python3. no criticism of the OP who could not know beforehand, but nonetheless it taints the value of this question as the go-to resource about pythonw.
    – mnagel
    Feb 24, 2017 at 15:35
  • Since this was recently updated I should clarify: in Python 3, print 'x' fails now because parentheses are required. Must use print('x').
    – Dana
    Oct 9, 2023 at 18:10

5 Answers 5

364

To summarize and complement the existing answers:

  • python.exe is a console (terminal) application for launching CLI-type scripts (console applications).

    • Unless run from an existing console window, python.exe opens a new console window.

    • Standard streams sys.stdin, sys.stdout and sys.stderr are connected to the console window.

    • Execution is synchronous when launched from a cmd.exe or PowerShell console window: See eryksun's 1st comment below.

      • If a new console window was created, it stays open until the script terminates.
      • When invoked from an existing console window, the prompt is blocked until the script terminates.
  • pythonw.exe is a GUI app for launching GUI/no-UI-at-all scripts.

    • NO console window is opened.
    • Execution is asynchronous:
      • When invoked from a console window, the script is merely launched and the prompt returns right away, whether the script is still running or not.
    • Standard streams sys.stdin, sys.stdout and sys.stderr are NOT available.
      • Caution: Unless you take extra steps, this has potentially unexpected side effects:
        • Unhandled exceptions cause the script to abort silently.
        • In Python 2.x, simply trying to use print() can cause that to happen (in 3.x, print() simply has no effect).
          • To prevent that from within your script, and to learn more, see this answer of mine.
          • Ad-hoc, you can use output redirection:Thanks, @handle.
            pythonw.exe yourScript.pyw 1>stdout.txt 2>stderr.txt
            (from PowerShell:
            cmd /c pythonw.exe yourScript.pyw 1>stdout.txt 2>stderr.txt) to capture stdout and stderr output in files.
            If you're confident that use of print() is the only reason your script fails silently with pythonw.exe, and you're not interested in stdout output, use @handle's command from the comments:
            pythonw.exe yourScript.pyw 1>NUL 2>&1
            Caveat: This output redirection technique does not work when invoking *.pyw scripts directly (as opposed to by passing the script file path to pythonw.exe). See eryksun's 2nd comment and its follow-ups below.

You can control which of the executables runs your script by default - such as when opened from Explorer - by choosing the right filename extension:

  • *.py files are by default associated (invoked) with python.exe
  • *.pyw files are by default associated (invoked) with pythonw.exe
9
  • 1
    PS: It does work when I pipe stdout and stderr somewhere: > pythonw ls.pyw >nul 2>&1 (even though nothing is written).
    – handle
    Jun 16, 2016 at 8:06
  • 1
    This synchronous and asynchronous behavior is just from the cmd.exe interactive command prompt without using the start command. It actually inspects the PEB of the child process to determine whether it's a console process. The console host process (conhost.exe) doesn't care about this. If you use subprocess.Popen to attach another python.exe instance to the current console and don't wait on it, then you'll have a confusing mess of both processes racing to access the console simultaneously.
    – Eryk Sun
    Jul 27, 2016 at 18:55
  • 2
    A user-mode process is created by the system call NtCreateUserProcess. If the target executable is a console program, the system unconditionally inherits the parent's standard handles. But for a non-console program it requires being explicitly told to inherit the parent's inheritable handles. To run a file based on a file association, cmd calls ShellExecuteEx, which does not explicitly inherit handles when it calls CreateProcess => NtCreateUserProcess. Consequently redirecting standard I/O works in cmd when starting console .py scripts but not non-console .pyw scripts.
    – Eryk Sun
    Jul 27, 2016 at 22:42
  • 2
    The cmd shell first tries CreateProcess with bInheritHandles passed as TRUE. It only falls back on ShellExecuteEx when CreateProcess fails because the target isn't a PE executable (e.g. it's a .py script) or requires elevation (e.g. osk.exe). So when you directly run pythonw.exe or pyw.exe, it will inherit cmd's StandardInput, StandardOutput, and StandardError, which cmd (actually the CRT) modifies via SetStdHandle before and after calling CreateProcess when standard I/O is redirected to a pipe, file, or device.
    – Eryk Sun
    Jul 28, 2016 at 3:34
  • 2
    Note that cmd does not use the STARTUPINFO handles (hStdInput, hStdOutput, hStdErr), unlike Python's subprocess.Popen. It can get away with this because it's a single-threaded program. It's only due to this design that redirection works at all with ShellExecuteEx (just for console programs, as noted) because the GUI shell API otherwise has no support for standard I/O.
    – Eryk Sun
    Jul 28, 2016 at 3:41
193

If you don't want a terminal window to pop up when you run your program, use pythonw.exe;
Otherwise, use python.exe

Regarding the syntax error: print is now a function in 3.x
So use instead:

print("a")
1
  • 1
    Running a .pyw file from Notepad++ I still get a console window. To prevent this I have to double-click the file name to open the app. Only then do I see just the GUI and no console.
    – Luther
    Jul 28, 2020 at 6:54
21

See here: http://docs.python.org/using/windows.html

pythonw.exe "This suppresses the terminal window on startup."

1
21

If you're going to call a python script from some other process (say, from the command line), use pythonw.exe. Otherwise, your user will continuously see a cmd window launching the python process. It'll still run your script just the same, but it won't intrude on the user experience.

An example might be sending an email; python.exe will pop up a CLI window, send the email, then close the window. It'll appear as a quick flash, and can be considered somewhat annoying. pythonw.exe avoids this, but still sends the email.

1
  • 6
    True, but re "say, from the command line": If you already are in a console (terminal) window, then python.exe will not open another one.
    – mklement0
    May 18, 2015 at 14:19
3

I was struggling to get this to work for a while. Once you change the extension to .pyw, make sure that you open properties of the file and direct the "open with" path to pythonw.exe.

Not the answer you're looking for? Browse other questions tagged or ask your own question.