Runtime Usage

Configuration Inputs

set_config and connect accept supported share URIs, complete JSON, or configuration paths accepted by V2Root Core.

client.set_config("vless://REPLACE_ME")
client.start()

from v2root import RuntimeStatus

client.start()
if client.runtime_status is RuntimeStatus.RUNNING:
    print("Connected")
client.stop()

Traffic values are cumulative bytes. Speed values are bytes per second.

import time

for _ in range(5):
    print(client.traffic)
    print(client.speed)
    time.sleep(1)

The first speed call establishes a native baseline and can return zero.

result = client.update_geo_assets("./resources")
print(result)

Run network and filesystem operations away from latency-sensitive UI threads.

normalized = client.parse("vmess://REPLACE_ME")
share_uri = client.to_share_uri(normalized)

Conversion is intentionally lossy for Xray fields without a share-URI equivalent.

from v2root import CoreManager

manager = CoreManager()
active = manager.ensure()
print(manager.installed())
manager.update()

Do not update, replace, or unload the core while its runtime is active.

from v2root import V2ROOT

client = V2ROOT()
client.set_config_string("vless://REPLACE_ME")
client.start()
client.stop()

New applications should use V2RootClient.