Skip to main content

qt-tour

PyPI Python License

Small guided tours for Python Qt applications.

qt-tour demo

from qt_tour import GuidedTour, TourAnchor, TourStep

GuidedTour(
    [
        TourStep(lambda: button, "Load data", "Load your dataset here."),
        TourStep(
            lambda: results_widget,
            "Results",
            "Results appear here.",
            anchor=TourAnchor.ABOVE,
        ),
    ],
    window,
).start()

Install

uv add qt-tour
uv add PyQt6  # or PySide6

qt-tour depends on qtpy; you provide the Qt binding.

Features

  • ordinary QWidget targets
  • lazy targets for widgets created later
  • left, right, above, below, and center anchors
  • overlay with target spotlight
  • Previous / Next / Finish / Skip navigation
  • Escape to close
  • conditional steps with skip
  • hidden-widget reveal hooks with ensure_visible
  • finished signal

Styling

Use Qt stylesheets:

app.setStyleSheet("""
#qt_tour_tooltip { background: #2b2b2b; color: white; border-radius: 8px; }
#qt_tour_title { font-weight: bold; }
#qt_tour_counter { color: #aaa; }
""")

Development

just help
just check
just docs-serve

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

qt_tour-0.1.0.tar.gz (5.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

qt_tour-0.1.0-py3-none-any.whl (6.5 kB view details)

Uploaded Python 3

File details

Details for the file qt_tour-0.1.0.tar.gz.

File metadata

  • Download URL: qt_tour-0.1.0.tar.gz
  • Upload date:
  • Size: 5.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.12.4 {"installer":{"name":"uv","version":"0.12.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for qt_tour-0.1.0.tar.gz
Algorithm Hash digest
SHA256 c73f2de8bf7eb68f2b0776c4802d6df8bf3dededbd8701f8633d94ebd0d19571
MD5 22ccfa072fe6d8b11783b01df5141596
BLAKE2b-256 1ae9a9762b7ef3890986feeadfcab67a31bb5958296fabaf42b577561bb8a968

See more details on using hashes here.

File details

Details for the file qt_tour-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: qt_tour-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 6.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.12.4 {"installer":{"name":"uv","version":"0.12.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for qt_tour-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 41fe4c0c116e32403db572448d75fffa06c2fe85a606c0d01824ddfe70b06ec3
MD5 230abe32cdf42e34cf56a5c6ac402c6f
BLAKE2b-256 ed2ec93026c08e9e2312f1d59faf2ace87c5407b8dd8f0fbc53872d172ec4574

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page