Metadata-Version: 2.1
Name: Nuitka-winsvc
Version: 1.4.7
Summary: Python compiler with full language support and CPython compatibility
Home-page: https://nuitka.net
Author: Kay Hayen
Author-email: Kay.Hayen@gmail.com
License: Apache License, Version 2.0
Project-URL: Commercial, https://nuitka.net/doc/commercial.html
Project-URL: Support, https://nuitka.net/pages/support.html
Project-URL: Documentation, https://nuitka.net/doc/user-manual.html
Project-URL: Donations, https://nuitka.net/pages/donations.html
Project-URL: Mastodon, https://fosstodon.org/@kayhayen
Project-URL: Twitter, https://twitter.com/KayHayen
Project-URL: Source, https://github.com/Nuitka/Nuitka
Keywords: compiler,python,nuitka
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Software Development :: Compilers
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Topic :: System :: Software Distribution
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: C
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: POSIX :: BSD :: FreeBSD
Classifier: Operating System :: POSIX :: BSD :: NetBSD
Classifier: Operating System :: POSIX :: BSD :: OpenBSD
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: MacOS
Classifier: Operating System :: Android
Classifier: License :: OSI Approved :: Apache Software License
Description-Content-Type: text/markdown
License-File: LICENSE.txt

# Nuitka-winsvc User Manual



Nuitka-winsvc is a forked version of Nuitka, it supports compiling EXE as a Windows service. 



## Install



You can install Nuitka-winsvc by pip: 



```shell

pip install nuitka-winsvc

```



## Usage



In addition to supporting all the command line arguments of Nuitka, Nuitka-winsvc also provides 5 additional arguments for compiling the Windows services:



- `--windows-service`  

  Enable Windows service mode, works only when compiling for Windows and onefile mode enabled.

- `--windows-service-name`  

  Name of the Windows service. If not provided, the target program name will be used as the service name.

- `--windows-service-display-name`  

  Display name of the Windows service. If not provided, the product name will be attempted to use.

- `--windows-service-description`  

  Description of the Windows service. If not provided, the file description will be attempted to use.

- `--windows-service-cmdline`  

  Additional command line arguments that will be passed to the Windows service. Just like `--config config.json --output output.log` .



Use the following command to build a Windows service:



```shell

python -m nuitka --onefile --output-dir=build --windows-service --windows-service-name=myservice --windows-service-display-name="My Service" --windows-service-description="This is the description of my service" --windows-service-cmdline="-c config.yml -o output.log" main.py

```



When the python program is compiled successfully, you can use the following command to install the service:



```shell

.\main.exe install

```



Also you can use the following command to install the service:



```shell

.\main.exe uninstall

```



Note: Administrator privileges is required when installing and uninstalling the Windows services. You should run the above commands as administrator. 



