Frequently Asked Questions

Back to Documentation Hub

Frequently Asked Questions

Bravura - Military-Grade Edition

Common questions and answers for users, developers, and decision makers

---

💼 Commercial & Licensing

Q: Is this production-ready for commercial applications?

A: Absolutely! Bravura is designed specifically for enterprise and commercial use. It features:

Q: What's included in each license tier?

Feature Standard ($1,999.99 Launch / $2,999.99 Regular) Professional ($3,999.99 Launch / $5,999.99 Regular) Enterprise ($19,999.99 Launch / $29,999.99 Regular)
Developers 1 developer Up to 5 developers Up to 25 developers
Activations 1 machine 5 machines 25 machines
Templates + Demos 4 + 10 9 + 15 12 + 18
Commercial Use ✓ Yes ✓ Yes ✓ Yes
Distribution Unlimited Unlimited Unlimited
White-labeling ✗ No ✗ No ✓ Yes (Monthly/Annual/Perpetual)
Source Code Access ✗ No ✗ No ✓ Yes (Annual/Perpetual only)
GPU Acceleration Basic ✓ Advanced ✓ Advanced
Support Standard Email (3-5 days) Standard Email (3-5 days) Priority Email (48 hours)
Updates 1 year 2 years Lifetime

Q: Can I distribute applications built with this toolkit?

A: Yes! All license tiers include royalty-free distribution rights. You can ship unlimited copies of applications you build with Bravura without additional fees. End users don't need separate licenses. (Note: You cannot redistribute the Bravura framework itself - only applications you create with it.)

Q: Can I modify my applications and integrate Bravura?

A: Yes! All license tiers allow you to modify and customize your applications that use Bravura:

What you CAN do (all tiers):

What requires source code access (Enterprise Annual/Perpetual only):

Important: You cannot redistribute Bravura's source code or framework separately. You can only distribute your compiled applications that incorporate Bravura.

Q: Is there a free trial?

A: Yes! We offer a 14-day full-featured trial so you can evaluate Bravura risk-free before purchasing. Trial versions include all core features of their respective tiers:

Trial Tier Activation Limit Templates + Demos Features
Standard Trial 1 machine 1 template + 2 demos All Standard features
Professional Trial 3 machines 2 templates + 3 demos All Professional features
Enterprise Trial 5 machines 3 templates + 4 demos Core Enterprise features (no source code or white-label)

Note: Enterprise trial does NOT include source code access (Annual/Perpetual only) or white-label rights (Monthly/Annual/Perpetual only).

Start your free trial - no credit card required.

Q: Should I choose a subscription or perpetual license?

A: Both options have their advantages:

Perpetual License (One-Time Purchase):

Subscription (Monthly/Annual):

Bottom line: Choose perpetual for long-term stability and predictable costs. Choose subscription for always being on the cutting edge with lower initial investment.

Q: What's the difference between white-labeling and source code access?

A: These are two separate Enterprise features with different requirements:

White-Label Rights (Enterprise Monthly/Annual/Perpetual):

Source Code Access (Enterprise Annual/Perpetual ONLY):

Key distinction: White-labeling lets you customize branding in your apps, while source code access lets you modify the Bravura framework itself. Enterprise Monthly subscribers get white-labeling but NOT source code access.

Q: What happens when my updates expire (perpetual license)?

A: Your license continues to work forever:

You simply won't receive:

Renewing updates is optional and typically costs 30-40% of the original license price for another year/two years of updates.

Q: What's your refund policy?

A: We offer a comprehensive 14-day money-back guarantee for most licenses:

Eligible for refunds:

NOT eligible for refunds:

Refund process (eligible licenses):

Why no refunds for Enterprise Annual/Perpetual? These licenses include full source code access, which cannot be revoked once accessed. We strongly recommend using the free 14-day Enterprise trial before purchasing to ensure it meets your needs.

Q: Do I get access to the Bravura source code?

A: Source code access depends on your license type:

Standard & Professional (all types): No source code access. You receive the compiled toolkit and can integrate it into your applications.

Enterprise Monthly: No source code access. Core features only.

Enterprise Annual: Full source code access while your subscription is active. Access is revoked if you cancel.

Enterprise Perpetual: Full lifetime source code access for ultimate customization and transparency.

Important: Source code access is only available with paid Enterprise Annual or Perpetual licenses - not with trial, monthly subscriptions, or lower tiers. This policy exists because source code cannot be revoked once accessed, which is why Enterprise Annual/Perpetual licenses are not eligible for refunds.

---

🔧 Technical Questions

Q: What Python versions are supported?

A: Bravura supports Python 3.7 and higher. We recommend Python 3.9+ for optimal performance and all features are thoroughly tested on Python 3.11. The framework takes advantage of modern Python features while maintaining backward compatibility with older versions.

Q: Does this work on my operating system?

A: The toolkit supports:

Q: What are the system requirements?

A:

Q: Do I need to install additional dependencies?

A: The core toolkit only requires Python's standard library (tkinter). Optional enhancements:

Q: How does GPU acceleration work?

A: The toolkit automatically detects compatible GPUs using:

No temporary files are created and all detection is done securely.

Q: Is the toolkit thread-safe?

A: Absolutely! Bravura is built with enterprise-grade thread safety from the ground up:

---

🎨 Features & Customization

Q: How many themes are included?

A: The number of themes depends on your license tier:

All themes include dark and light variants with professional color schemes.

Q: Can I create custom themes?

A: Yes! You can:

See THEMING_GUIDE.md for complete instructions.

Q: What makes Bravura's progress bars special?

A: Bravura's progress bars set a new standard for visual feedback:

Visual Excellence:

Technical Excellence:

Customization:

Users consistently tell us our progress bars are the most beautiful and professional they've seen in Python applications.

Q: How do I integrate this with my existing application?

A: Multiple integration approaches:

  1. Subclass AnalysisGUIFramework and add your functionality
  2. Import components like themes and progress bars individually
  3. Use the API with helper methods like log(), set_progress(), run_task()
  4. Embed sections into your existing tkinter applications

See INTEGRATION_GUIDE.md for detailed examples.

Q: Can I integrate Bravura with databases and external tools?

A: Absolutely! Bravura integrates seamlessly with any Python-compatible technology:

Databases:

External Tools & APIs:

Best Practice: Use Bravura's worker thread system to run long database operations in the background while showing progress to users.

Q: How do I package and deploy applications built with Bravura?

A: Bravura works with all standard Python packaging tools:

Packaging Options:

Deployment:

The process is simple:

  1. Develop with Bravura normally
  2. Run PyInstaller/your chosen tool
  3. Test the packaged application
  4. Distribute to users

Bravura includes packaging guides and example build scripts for common scenarios.

Q: What's the performance overhead of using Bravura?

A: Bravura is designed to be lightweight and fast:

Startup Performance:

Runtime Performance:

Optimization:

Bottom line: Bravura adds minimal overhead while delivering professional UI/UX that would take months to build from scratch.

---

⚡ Performance & Reliability

Q: How fast is the logging system?

A: The ring-buffer logging system achieves:

Q: Will the UI freeze during long operations?

A: No! The toolkit features:

Q: How much memory does it use?

A: Memory usage is optimized:

Q: Is it stable enough for 24/7 operations?

A: Absolutely! Bravura is designed for mission-critical applications running 24/7:

Many of our enterprise customers run Bravura-based applications as services with 99.9%+ uptime.

Q: Does Bravura work offline / in air-gapped environments?

A: Yes! Bravura fully supports offline and air-gapped deployments:

For air-gapped systems, we provide offline license files that can be transferred via USB or other secure methods. The application continues to function completely offline once activated.

Q: Can I white-label Bravura for my product?

A: White-labeling is exclusively available for Enterprise licenses (Annual or Perpetual only):

Standard & Professional: No white-labeling. Bravura branding remains in the framework.

Enterprise Monthly: No white-labeling rights.

Enterprise Annual/Perpetual: Full white-labeling rights included.

What white-labeling includes:

White-label vs Source Code: White-labeling allows you to rebrand Bravura without needing to modify source code. You customize branding through configuration files and the theming system. This is separate from source code access, though both are Enterprise-only features.

This allows Enterprise customers to deliver a fully branded experience to their end users.

Q: Can I transfer my license to another developer or company?

A: Yes! License transfers are supported:

Simply email support@wigleystudios.com with transfer details and we'll process it within 1 business day.

Q: How does team/multi-developer licensing work?

A: One license covers multiple developers based on your tier:

Standard (1 developer):

Professional (Up to 5 developers):

Enterprise (Up to 25 developers):

Activations vs Developers: Each developer can activate Bravura on their development machine(s). The activation limit controls total machines, while the developer limit controls team size.

Q: What about security and compliance?

A: Bravura is built with security and compliance in mind:

Security Features:

Compliance:

Your data stays yours - Bravura never phones home from your deployed applications.

Q: Does Bravura support internationalization (i18n) and multiple languages?

A: Yes! Bravura is designed for international deployment:

The framework itself uses English, but your applications can be fully localized into any language. We provide helper utilities and examples for common i18n patterns.

---

🚀 Getting Started

Q: How quickly can I get started?

A: Incredibly quickly! Here's a minimal example to get a professional GUI running in seconds:


from bravura import AnalysisGUIFramework

# Create and run your application
app = AnalysisGUIFramework()
app.run()

That's it! You immediately have a full professional application with:

Q: Are there examples and tutorials?

A: Comprehensive examples included:

Q: What if I need help getting started?

A: Multiple support options:

Q: Can I see it working before I buy?

A: Absolutely! We offer multiple ways to evaluate Bravura before making a purchase decision:

  1. Free 14-day trial - Full access to all features, no credit card required
  2. Live interactive demos - Try Bravura directly on our website
  3. Video demonstrations - Comprehensive walkthroughs on our YouTube channel
  4. Code examples - Browse our extensive example library and templates
  5. Enterprise presentations - Schedule a personalized demo with our team

We're confident you'll love Bravura once you see it in action.

---

🛠️ Development & Integration

Q: Can I use this with other GUI frameworks?

A: The toolkit is built on tkinter, but components can be integrated with:

Q: How do I handle background tasks?

A: Use the built-in worker system:


def my_background_task(emit, cancel):
    for i in range(100):
        if cancel.is_set():
            return
        emit("PROGRESS", percent=i, message=f"Step {i}")
        # Do work here

app.worker.run(my_background_task, on_message=app._on_worker_message)

Q: Can I customize the file management features?

A: Yes! You can:

Q: How do I add my own UI sections?

A: Subclass and extend:


class MyApp(AnalysisGUIFramework):
    def _create_additional_sections(self):
        # Add your custom UI here
        my_frame = tk.Frame(self.main_frame)
        # ... your widgets ...

---

🆘 Support & Troubleshooting

Q: The window appears too small on my high-DPI display

A: High-DPI support is automatic, but you can adjust:

  1. Check Windows display scaling settings
  2. Modify window size in your code: app.root.geometry("1200x800")
  3. Use theme scaling options in gui_config.json

Q: GPU is not detected on my system

A: Try these steps:

  1. Install GPUtil: pip install GPUtil
  2. Check if NVIDIA drivers are installed
  3. Run python validate_gpu.py for diagnostics
  4. For integrated graphics, detection is expected to use system methods

Q: Themes don't seem to apply correctly

A: Common solutions:

  1. Delete gui_config.json and restart to reset
  2. Ensure proper theme name: app.theme_manager.apply_theme("dark")
  3. Check for conflicting custom styling
  4. Verify tkinter version supports all features

Q: I'm getting "TclError: invalid command name" when using PremiumButton in dialogs

A: This error occurs when PremiumButton is used in transient dialogs (tk.Toplevel). The button's asynchronous loading animations can outlive the dialog lifecycle.

Solution:

For transient dialogs, use tk.Button with direct configuration instead:


import tkinter as tk
from tkinter import font as tkfont

# In your dialog
button_font = tkfont.Font(family="Segoe UI", size=10, weight="bold")

save_btn = tk.Button(
    dialog,
    text="Save",
    command=save_action,
    font=button_font,
    width=10,
    bg='#20C6B7',
    fg='#FFFFFF',
    activebackground='#18B1A5',
    relief='raised',
    cursor='hand2'
)

Why this works:

When to use each button type:

See BUTTON_USAGE_GUIDE.md for complete details and examples.

Q: My dialog buttons change size when I switch themes

A: This happens when using ttk.Button in dialogs, as the theme manager's global ttk.Style modifications affect all ttk widgets.

Solution:

Use tk.Button with direct configuration in transient dialogs instead of ttk.Button:


# Replace ttk.Button
btn = ttk.Button(dialog, text="OK", command=action)

# With tk.Button
btn = tk.Button(
    dialog,
    text="OK",
    command=action,
    font=("Segoe UI", 10, "bold"),
    width=10,
    bg='#20C6B7',
    fg='#FFFFFF',
    relief='raised'
)

This ensures consistent sizing regardless of theme changes. See the "Buttons in Transient Dialogs" section of BUTTON_USAGE_GUIDE.md for the complete pattern.

Q: I'm getting import errors

A: Verify your setup:

  1. Ensure you're in the correct directory with gui_main.py
  2. Check Python path: sys.path.insert(0, "path/to/toolkit")
  3. Verify Python version: python --version (should be 3.7+)
  4. Test with: python quick_test.py

Q: Where do I get help if I'm still stuck?

A: Multiple support channels:

For License Holders:

Community Support:

Documentation:

---

📊 Business Questions

Q: Why choose Bravura over building a custom GUI?

A: Bravura delivers significant competitive advantages:

Q: How does Bravura compare to other GUI frameworks?

A: Bravura offers unique advantages over alternatives:

vs. tkinter (raw): Bravura provides professional themes, components, and architecture - saving months of development

vs. PyQt/PySide: No expensive Qt licensing, simpler API, lighter weight, pure Python

vs. Kivy: Better desktop experience, native look-and-feel, enterprise support

vs. Electron: Native Python performance, smaller footprint, no JavaScript required

Bravura advantages:

Q: What's your update and support policy?

A: We provide:

Q: Can we get custom features developed?

A: Yes! Enterprise customers get:

Contact sales@wigleystudios.com for custom development.

---

💡 Have More Questions?

Can't find what you're looking for? We're here to help!

Sales & Licensing

Technical Support

General Inquiries

---

Last Updated: October 22, 2025

Version: 1.0.0 General Availability

Next Review: November 22, 2025

This comprehensive FAQ is continuously updated based on customer feedback and common questions. Have a suggestion? Email support@wigleystudios.com

Last updated: October 28, 2025

© 2025 Wigley Studios. All rights reserved. Ultimate Video Game Studio - Volume 1 is a trademark of Wigley Studios.