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.2.0.tar.gz (5.8 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.2.0-py3-none-any.whl (6.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: qt_tour-0.2.0.tar.gz
  • Upload date:
  • Size: 5.8 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.2.0.tar.gz
Algorithm Hash digest
SHA256 30214c904971e72ac8714bcf7567f8eb602422b518d17b6fa388a73abfa770ff
MD5 7b95740f98959f9c35223027afb96a79
BLAKE2b-256 807e380e2b57e8732870ea0e122b22a0ec6fe4a62e51deda08af3fe334937fcc

See more details on using hashes here.

File details

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

File metadata

  • Download URL: qt_tour-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 6.4 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.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 6bc32380fcd4f176a734c8795e128e198c262a4c7cf3e7c7601bf84f297c3b40
MD5 5e038d80cb1e0d0530a01be52cf79e7a
BLAKE2b-256 b84c4164f8d1be5ee58bc3d421f2cc9cc2ab54e54341401a7104200739570bd9

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