commited with removed gtk wrapper. Simple python run file with all requirements.
This commit is contained in:
@@ -1,140 +0,0 @@
|
||||
# GTK Wrapper for Flask Application
|
||||
|
||||
This wrapper embeds your Flask web application in a native GTK window using WebKit2, providing a desktop application experience.
|
||||
|
||||
## Installation
|
||||
|
||||
### Prerequisites
|
||||
- Python 3.6+
|
||||
- GTK 3.0
|
||||
- WebKit2 4.0
|
||||
- PyGObject
|
||||
|
||||
### Automatic Setup (Linux)
|
||||
|
||||
Run the provided setup script:
|
||||
```bash
|
||||
bash setup_gtk_wrapper.sh
|
||||
```
|
||||
|
||||
This will install all required system packages and Python dependencies.
|
||||
|
||||
### Manual Setup
|
||||
|
||||
If the automated script doesn't work for your system, install the packages manually:
|
||||
|
||||
**Ubuntu/Debian:**
|
||||
```bash
|
||||
sudo apt-get update
|
||||
sudo apt-get install -y python3-gi gir1.2-gtk-3.0 gir1.2-webkit2-4.1 libgtk-3-0 libwebkit2gtk-4.1-0
|
||||
pip3 install flask
|
||||
```
|
||||
|
||||
**Fedora/RHEL:**
|
||||
```bash
|
||||
sudo dnf install python3-gobject gtk3 webkit2-gtk3
|
||||
pip3 install flask
|
||||
```
|
||||
|
||||
**Arch Linux:**
|
||||
```bash
|
||||
sudo pacman -S python-gobject gtk3 webkit2gtk
|
||||
pip3 install flask
|
||||
```
|
||||
|
||||
**macOS (via Homebrew):**
|
||||
```bash
|
||||
brew install gtk+3 webkit2gtk python3
|
||||
pip3 install flask
|
||||
```
|
||||
|
||||
## Usage
|
||||
|
||||
Run the GTK wrapper with:
|
||||
```bash
|
||||
python3 gtk_wrapper.py
|
||||
```
|
||||
|
||||
Or make it executable and run directly:
|
||||
```bash
|
||||
chmod +x gtk_wrapper.py
|
||||
./gtk_wrapper.py
|
||||
```
|
||||
|
||||
## Features
|
||||
|
||||
- **Native GTK Window**: Runs your Flask app in a native GTK 3 window
|
||||
- **WebKit2 Rendering**: Uses WebKit2 for modern web rendering
|
||||
- **Background Flask Server**: Automatically starts your Flask app in a background thread
|
||||
- **Developer Mode**: Developer tools are enabled for debugging (inspect element)
|
||||
- **Responsive UI**: Window is resizable and responsive
|
||||
|
||||
## Configuration
|
||||
|
||||
You can customize the wrapper by editing `gtk_wrapper.py`:
|
||||
|
||||
### Window Size
|
||||
```python
|
||||
self.set_default_size(1200, 800) # Change to desired width, height
|
||||
```
|
||||
|
||||
### Window Title
|
||||
```python
|
||||
self.set_title('Your App Title')
|
||||
```
|
||||
|
||||
### Flask Server Port
|
||||
```python
|
||||
self.flask_port = 5000 # Change to desired port
|
||||
```
|
||||
|
||||
### Developer Tools
|
||||
To disable developer tools (inspect element), comment out:
|
||||
```python
|
||||
self.webview.get_settings().set_property('enable-developer-extras', True)
|
||||
```
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### "No module named 'gi'"
|
||||
Install PyGObject: `pip3 install PyGObject`
|
||||
|
||||
### "gi.repository.Gtk" not found
|
||||
Install GTK bindings: `sudo apt-get install python3-gi gir1.2-gtk-3.0`
|
||||
|
||||
### "gi.repository.WebKit2" not found
|
||||
Install WebKit2 bindings: `sudo apt-get install gir1.2-webkit2-4.0`
|
||||
|
||||
### Flask server won't start
|
||||
- Check if port 5000 is already in use
|
||||
- Ensure you're running from the correct directory
|
||||
- Check Flask app for syntax errors
|
||||
|
||||
### Page shows "Unable to reach" error
|
||||
- Wait a few seconds for the Flask server to start
|
||||
- Check the terminal for Flask startup messages
|
||||
- Ensure all Flask dependencies are installed
|
||||
|
||||
## File Structure
|
||||
|
||||
```
|
||||
TV_APP_V1.0.0/
|
||||
├── app.py # Your Flask application
|
||||
├── gtk_wrapper.py # GTK wrapper (this file)
|
||||
├── setup_gtk_wrapper.sh # Automated setup script
|
||||
├── GTK_WRAPPER_README.md # This file
|
||||
├── templates/ # Flask templates
|
||||
├── static/ # Flask static files
|
||||
└── locales/ # Language files
|
||||
```
|
||||
|
||||
## Notes
|
||||
|
||||
- The Flask app runs in debug mode disabled to prevent auto-reloading conflicts with GTK
|
||||
- The app uses threading to run Flask in the background without blocking GTK events
|
||||
- All Flask features (routing, sessions, file uploads, etc.) work normally
|
||||
|
||||
## Support
|
||||
|
||||
For issues with the Flask app itself, see the main app documentation.
|
||||
For GTK/WebKit issues, refer to the respective project documentation.
|
||||
-107
@@ -1,107 +0,0 @@
|
||||
#!/usr/bin/env python3
|
||||
"""
|
||||
GTK Wrapper for Flask Application
|
||||
Runs the Flask app in a separate thread and displays it in a GTK window using WebKit
|
||||
"""
|
||||
|
||||
import sys
|
||||
import threading
|
||||
import time
|
||||
import gi
|
||||
import os
|
||||
from pathlib import Path
|
||||
|
||||
gi.require_version('Gtk', '3.0')
|
||||
gi.require_version('WebKit2', '4.1')
|
||||
|
||||
from gi.repository import Gtk, WebKit2, GLib
|
||||
|
||||
# Import the Flask app
|
||||
from app import app as flask_app
|
||||
|
||||
|
||||
class FlaskWindow(Gtk.ApplicationWindow):
|
||||
def __init__(self, application):
|
||||
super().__init__(application=application)
|
||||
|
||||
self.flask_thread = None
|
||||
self.flask_port = 5000
|
||||
self.flask_host = '127.0.0.1'
|
||||
self.flask_url = f'http://{self.flask_host}:{self.flask_port}/'
|
||||
|
||||
# Configure window
|
||||
self.set_title('Shooting Range Management System')
|
||||
self.set_default_size(1200, 800)
|
||||
self.set_position(Gtk.WindowPosition.CENTER)
|
||||
|
||||
# Create WebKit view
|
||||
self.webview = WebKit2.WebView()
|
||||
self.webview.get_settings().set_property('enable-developer-extras', True)
|
||||
|
||||
# Create container
|
||||
container = Gtk.Box(orientation=Gtk.Orientation.VERTICAL)
|
||||
container.pack_start(self.webview, True, True, 0)
|
||||
|
||||
self.add(container)
|
||||
self.connect('destroy', self.on_destroy)
|
||||
|
||||
# Start Flask server in background
|
||||
self.start_flask_server()
|
||||
|
||||
# Load the Flask app in WebView after a short delay to ensure server is ready
|
||||
GLib.timeout_add(2000, self.load_flask_url)
|
||||
|
||||
def start_flask_server(self):
|
||||
"""Start Flask development server in a separate thread"""
|
||||
def run_flask():
|
||||
# Change to app directory to ensure relative paths work
|
||||
app_dir = Path(__file__).parent
|
||||
os.chdir(app_dir)
|
||||
|
||||
# Run Flask app
|
||||
flask_app.run(
|
||||
host=self.flask_host,
|
||||
port=self.flask_port,
|
||||
debug=False,
|
||||
use_reloader=False,
|
||||
threaded=True
|
||||
)
|
||||
|
||||
self.flask_thread = threading.Thread(target=run_flask, daemon=True)
|
||||
self.flask_thread.start()
|
||||
print(f"Flask server starting on {self.flask_url}")
|
||||
|
||||
def load_flask_url(self):
|
||||
"""Load the Flask application in the WebView"""
|
||||
try:
|
||||
self.webview.load_uri(self.flask_url)
|
||||
print(f"Loading {self.flask_url}")
|
||||
return False # Don't repeat
|
||||
except Exception as e:
|
||||
print(f"Error loading Flask URL: {e}")
|
||||
return False
|
||||
|
||||
def on_destroy(self, widget):
|
||||
"""Handle window close event"""
|
||||
print("Closing application...")
|
||||
Gtk.main_quit()
|
||||
|
||||
|
||||
class FlaskGTKApp(Gtk.Application):
|
||||
def __init__(self):
|
||||
super().__init__(application_id='com.example.flaskgtk')
|
||||
self.connect('activate', self.on_activate)
|
||||
|
||||
def on_activate(self, app):
|
||||
window = FlaskWindow(app)
|
||||
window.show_all()
|
||||
window.present()
|
||||
|
||||
|
||||
def main():
|
||||
app = FlaskGTKApp()
|
||||
return app.run(sys.argv)
|
||||
|
||||
|
||||
if __name__ == '__main__':
|
||||
sys.exit(main())
|
||||
@@ -1,23 +0,0 @@
|
||||
#!/bin/bash
|
||||
# Setup script for GTK Wrapper dependencies
|
||||
|
||||
echo "Installing GTK wrapper dependencies..."
|
||||
|
||||
# Update package list
|
||||
sudo apt-get update
|
||||
|
||||
# Install GTK3 and WebKit2 development libraries
|
||||
echo "Installing GTK3 and WebKit2 libraries..."
|
||||
sudo apt-get install -y \
|
||||
python3-gi \
|
||||
gir1.2-gtk-3.0 \
|
||||
gir1.2-webkit2-4.0 \
|
||||
libgtk-3-0 \
|
||||
libwebkit2gtk-4.0-37
|
||||
|
||||
# Install pip packages if needed
|
||||
echo "Checking Python dependencies..."
|
||||
pip3 install flask
|
||||
|
||||
echo "Setup complete! You can now run the GTK wrapper with:"
|
||||
echo " python3 gtk_wrapper.py"
|
||||
Executable
+111
@@ -0,0 +1,111 @@
|
||||
#!/usr/bin/env python3
|
||||
"""
|
||||
TV_APP V1.0.0 - One-Click Launcher
|
||||
Automatically installs dependencies and starts the web application
|
||||
"""
|
||||
|
||||
import os
|
||||
import sys
|
||||
import subprocess
|
||||
import webbrowser
|
||||
import time
|
||||
import importlib.util
|
||||
|
||||
def check_python_version():
|
||||
"""Check if Python 3.7+ is available"""
|
||||
if sys.version_info < (3, 7):
|
||||
print("ERROR: Python 3.7+ is required")
|
||||
print(f"You have Python {sys.version}")
|
||||
return False
|
||||
return True
|
||||
|
||||
def check_and_install_flask():
|
||||
"""Check if Flask is installed, install if not"""
|
||||
flask_spec = importlib.util.find_spec("flask")
|
||||
|
||||
if flask_spec is not None:
|
||||
import flask
|
||||
print(f"✓ Flask is installed: v{flask.__version__}")
|
||||
return True
|
||||
|
||||
print("⚠ Flask not found. Installing...")
|
||||
try:
|
||||
subprocess.check_call([sys.executable, "-m", "pip", "install", "flask", "-q"])
|
||||
print("✓ Flask installed successfully")
|
||||
return True
|
||||
except subprocess.CalledProcessError:
|
||||
print("ERROR: Failed to install Flask")
|
||||
return False
|
||||
|
||||
def main():
|
||||
"""Main installation and startup routine"""
|
||||
print("\n" + "="*70)
|
||||
print(" TV_APP V1.0.0 - Installation & Launcher")
|
||||
print("="*70 + "\n")
|
||||
|
||||
# Check Python version
|
||||
print("[1/4] Checking Python version...")
|
||||
if not check_python_version():
|
||||
print("\nPlease install Python 3.7 or higher")
|
||||
input("Press Enter to exit...")
|
||||
return False
|
||||
|
||||
import flask
|
||||
print(f"✓ Python {sys.version.split()[0]} found\n")
|
||||
|
||||
# Check Flask
|
||||
print("[2/4] Checking Flask installation...")
|
||||
if not check_and_install_flask():
|
||||
input("Press Enter to exit...")
|
||||
return False
|
||||
print()
|
||||
|
||||
# Verify app.py exists
|
||||
print("[3/4] Verifying application files...")
|
||||
app_path = os.path.join(os.path.dirname(__file__), "app.py")
|
||||
if not os.path.exists(app_path):
|
||||
print(f"ERROR: app.py not found at {app_path}")
|
||||
input("Press Enter to exit...")
|
||||
return False
|
||||
print("✓ Application found: app.py\n")
|
||||
|
||||
# Start the app
|
||||
print("[4/4] Starting web application...\n")
|
||||
print("="*70)
|
||||
print(" TV_APP is starting...")
|
||||
print("="*70)
|
||||
print("\nThe application will be available at: http://localhost:5000")
|
||||
print("Press Ctrl+C to stop the server\n")
|
||||
|
||||
time.sleep(2)
|
||||
|
||||
# Open browser
|
||||
try:
|
||||
webbrowser.open("http://localhost:5000", new=1)
|
||||
except:
|
||||
pass
|
||||
|
||||
# Change to app directory and run
|
||||
os.chdir(os.path.dirname(__file__))
|
||||
|
||||
try:
|
||||
# Import and run the Flask app
|
||||
import app
|
||||
app.app.run(host='0.0.0.0', port=5000, debug=True, use_reloader=False)
|
||||
except ImportError as e:
|
||||
print(f"ERROR: Could not import app.py: {e}")
|
||||
input("Press Enter to exit...")
|
||||
return False
|
||||
except KeyboardInterrupt:
|
||||
print("\n\nServer stopped by user")
|
||||
return True
|
||||
except Exception as e:
|
||||
print(f"ERROR: {e}")
|
||||
input("Press Enter to exit...")
|
||||
return False
|
||||
|
||||
return True
|
||||
|
||||
if __name__ == "__main__":
|
||||
success = main()
|
||||
sys.exit(0 if success else 1)
|
||||
File diff suppressed because it is too large
Load Diff
File diff suppressed because it is too large
Load Diff
+1513
-1478
File diff suppressed because it is too large
Load Diff
Reference in New Issue
Block a user