SDK DocsEvolis Class

Evolis — Global Library Management

evolis.Evolis provides static utilities for the underlying libevolis C library.

Constants

ConstantValueDescription
TIMEOUT30000Default communication timeout (ms)
PRINT_TIMEOUT300000Default print job timeout (ms)
SESSION_FREE0Printer session is free
SESSION_MANAGE1Session held by evoservice
SESSION_PRINT2Session held during printing
SESSION_UI3Session held by evomanager
SESSION_WAIT5000Recommended wait when reserving
SESSION_TIMEOUT45Session auto-release timeout (s)

Static Methods

Evolis.set_library_path(path: str) -> None

Load the native C library from a custom path.
Called automatically on import evolis — only needed if the bundled library is not used.

Evolis.get_version() -> str

Returns the version string of the underlying libevolis.

import evolis
print(evolis.Evolis.get_version())

Evolis.get_devices() -> list[Device]

Returns a list of all Evolis printers installed on the system.

devices = evolis.Evolis.get_devices()
for d in devices:
    print(d.name, d.type)

Evolis.get_model_name(model: Model) -> str

Returns the human-readable name of a Model enum value (without brand prefix).

Evolis.set_log_level(level: LogLevel) -> None

Set the log verbosity of libevolis.

evolis.Evolis.set_log_level(evolis.LogLevel.DEBUG)

Evolis.set_log_path(path: str) -> None

Redirect log output to a file.

evolis.Evolis.set_log_path("/tmp/evolis.log")

Evolis.set_console_output(on: bool) -> None

Enable or disable log output to stderr.

evolis.Evolis.set_console_output(True)

Device Object

Device instances returned by get_devices() have the following attributes:

AttributeTypeDescription
namestrPrinter name usable in Connection()
typeTypePrinter type enum

Enabling Debug Logging

import evolis
 
evolis.Evolis.set_console_output(True)
evolis.Evolis.set_log_level(evolis.LogLevel.DEBUG)
evolis.Evolis.set_log_path("/tmp/evolis_debug.log")