{"id":34520182,"url":"https://github.com/dawidpereira/quetty","last_synced_at":"2026-06-10T05:01:02.959Z","repository":{"id":289528578,"uuid":"971564482","full_name":"dawidpereira/quetty","owner":"dawidpereira","description":"Quetty the cutest queue manager \u003c3","archived":false,"fork":false,"pushed_at":"2026-06-07T03:22:53.000Z","size":2546,"stargazers_count":19,"open_issues_count":1,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-06-07T05:19:39.081Z","etag":null,"topics":["azure","azure-service-bus","explorer","management","queue","servicebus","terminal","tui"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dawidpereira.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-04-23T18:01:02.000Z","updated_at":"2026-04-19T20:24:09.000Z","dependencies_parsed_at":"2026-02-15T05:03:21.824Z","dependency_job_id":null,"html_url":"https://github.com/dawidpereira/quetty","commit_stats":null,"previous_names":["dawidpereira/quetty"],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/dawidpereira/quetty","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dawidpereira%2Fquetty","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dawidpereira%2Fquetty/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dawidpereira%2Fquetty/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dawidpereira%2Fquetty/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dawidpereira","download_url":"https://codeload.github.com/dawidpereira/quetty/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dawidpereira%2Fquetty/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34137570,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-10T02:00:07.152Z","response_time":89,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["azure","azure-service-bus","explorer","management","queue","servicebus","terminal","tui"],"created_at":"2025-12-24T04:46:18.638Z","updated_at":"2026-06-10T05:01:02.942Z","avatar_url":"https://github.com/dawidpereira.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Quetty\n\n\u003cdiv align=\"center\"\u003e\n\n[![Version](https://img.shields.io/badge/version-0.1.0-blue?style=for-the-badge)](https://github.com/dawidpereira/quetty/releases/tag/v0.1.0)\n[![Status](https://img.shields.io/badge/status-beta-yellow?style=for-the-badge)](#-development-phase)\n[![Rust](https://img.shields.io/badge/rust-%23000000.svg?style=for-the-badge\u0026logo=rust\u0026logoColor=white)](https://www.rust-lang.org/)\n[![Azure](https://img.shields.io/badge/azure-%230072C6.svg?style=for-the-badge\u0026logo=microsoftazure\u0026logoColor=white)](https://azure.microsoft.com/en-us/products/service-bus)\n[![Terminal](https://img.shields.io/badge/Terminal-%23054020?style=for-the-badge\u0026logo=gnu-bash\u0026logoColor=white)](#)\n[![TUI](https://img.shields.io/badge/TUI-Ratatui-blueviolet?style=for-the-badge\u0026logo=terminal\u0026logoColor=white)](https://github.com/ratatui-org/ratatui)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge)](https://opensource.org/licenses/MIT)\n\n\u003c/div\u003e\n\nA powerful terminal-based Azure Service Bus queue manager that provides an intuitive interface for viewing, managing, and interacting with message queues efficiently.\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"assets/quetty-logo-only-transparent.png\" alt=\"Quetty Logo\" width=\"320\" height=\"320\"\u003e\n\u003c/div\u003e\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"assets/quetty-text-only-transparent.png\" alt=\"Quetty\" width=\"640\"\u003e\n\u003c/div\u003e\n\n## Table of Contents\n\n- [Overview](#overview)\n- [Interface Preview](#interface-preview)\n- [Key Features](#key-features)\n- [Installation](#installation)\n- [Development](#development)\n- [Documentation](#documentation)\n- [Roadmap](#roadmap)\n- [Acknowledgments](#acknowledgments)\n- [License](#license)\n\n## Overview\n\nQuetty combines the power of Azure Service Bus with a sleek terminal interface, making queue management accessible and efficient. Whether you're debugging message flows, managing dead letter queues, or performing bulk operations, Quetty provides the tools you need in a fast, keyboard-driven environment.\n\n## 🚧 Development Phase\n\n**Quetty is currently in Beta**\n\nWe are actively developing and testing Quetty to ensure it meets production standards. During this phase, we're focusing on:\n\n- ✅ **Performance \u0026 UI Testing**: Verifying optimal performance across different environments and platforms. | Tested on most common terminal emulators (Ghostty *recomended*, WezTerm, ITerm2, Warp, macOS defaul Terminal *not recomended*).\n- ✅ **Nightly Builds**: Automated nightly builds available for all major platforms (Linux, Windows, macOS)\n- ✅ **Installation Methods**: Multiple installation options including nightly builds and source compilation\n- ⏳ **Configuration System**: Implementing a fully working configuration system with easy setup for binary installations\n- ⏳ **Action Verification**: Adding deep verification for destructive operations (like delete actions) to prevent accidental data loss\n\nWhile Quetty is functional and actively used in development environments, please exercise caution when using it in production scenarios. We recommend thorough testing in your specific environment before deploying to production systems.\n\n### 🧪 Beta Testing\n\nWant to participate in beta testing? We'd love your feedback! Contact us via:\n\n- **GitHub Issues**: [Open an issue](https://github.com/dawidpereira/quetty/issues) for bug reports and feature requests\n- **Email**: \u003cpereiradawid@outlook.com\u003e\n- **LinkedIn**: [www.linkedin.com/in/pereiradawid](https://www.linkedin.com/in/pereiradawid)\n\nYour testing and feedback help us build a better tool for the entire Azure Service Bus community.\n\n## Interface Preview\n\n### 🎥 Live Demo\n\nSee Quetty in action with this interactive demo showcasing core features:\n\n\u003chttps://github.com/user-attachments/assets/f52fb894-47a5-4287-b936-9e2b437a308a\u003e\n\n## Key Features\n\n### 🔍 **Message Management**\n\n- **Smart Preview**: Automatically previews messages with syntax highlighting\n- **Efficient Pagination**: Browse large queues with intelligent caching\n- **Bulk Operations**: Delete, send, or manage multiple messages at once\n- **Message Editing**: Edit and resend messages directly from the interface\n\n### 🔄 **Dead Letter Queue Support**\n\n- **Seamless DLQ Navigation**: Switch between main and dead letter queues\n- **Message Recovery**: Resend messages from DLQ back to main queue\n- **Bulk DLQ Operations**: Handle multiple messages efficiently\n\n### 🎯 **Azure Integration**\n\n- **Multiple Auth Methods**: Device code, client credentials, connection strings\n- **Azure Discovery**: Automatically discover subscriptions, resource groups, and namespaces\n- **Queue Statistics**: Real-time queue metrics and health monitoring\n\n### 📁 **Profile Management**\n\n- **Multi-Environment Support**: Separate profiles for dev, staging, production\n- **Profile Switching**: Quick environment switching with `--profile` flag\n- **Secure Isolation**: Each profile has isolated configuration and credentials\n- **Easy Setup**: Interactive setup wizard for each environment\n\n### 🎨 **User Experience**\n\n- **Intuitive Interface**: Keyboard-driven navigation with vim-like shortcuts\n- **Customizable Themes**: Built-in themes (Catppuccin, Nightfox, Quetty) with custom theme support\n- **Real-time Updates**: Instant feedback with smart state management\n- **Comprehensive Help**: Context-aware help system\n\n## Quick Start\n\n### Prerequisites\n\n- [Rust](https://rustup.rs/) (latest stable version)\n- Azure Service Bus namespace with appropriate permissions\n\n### Installation\n\n#### Option 1: One-Line Installation 🚀 (Recommended)\n\nThe fastest way to get Quetty running on any platform:\n\n**Unix/Linux/macOS:**\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/dawidpereira/quetty/main/install.sh | sh\n```\n\n**Windows PowerShell:**\n\n```powershell\nInvoke-RestMethod -Uri \"https://raw.githubusercontent.com/dawidpereira/quetty/main/install.ps1\" | Invoke-Expression\n```\n\n**What the installer does:**\n\n- ✅ Auto-detects your platform and architecture\n- ✅ Downloads the correct pre-built binary\n- ✅ Verifies SHA256 checksum for security\n- ✅ Installs to your PATH (`~/.local/bin` or system directory)\n- ✅ Ready to use immediately\n\n**Advanced options:**\n\n```bash\n# Install specific version\ncurl -fsSL https://raw.githubusercontent.com/dawidpereira/quetty/main/install.sh | sh -s -- --version v0.1.0\n\n# Install to custom directory\ncurl -fsSL https://raw.githubusercontent.com/dawidpereira/quetty/main/install.sh | sh -s -- --install-dir /opt/bin\n\n# System-wide installation (requires sudo)\ncurl -fsSL https://raw.githubusercontent.com/dawidpereira/quetty/main/install.sh | sh -s -- --system\n\n# Install nightly build\ncurl -fsSL https://raw.githubusercontent.com/dawidpereira/quetty/main/install.sh | sh -s -- --channel nightly\n\n# Preview what will be installed (dry run)\ncurl -fsSL https://raw.githubusercontent.com/dawidpereira/quetty/main/install.sh | sh -s -- --dry-run\n```\n\n**Supported platforms:**\n\n- Linux x64, macOS Intel/Apple Silicon, Windows x64/ARM64\n\n#### Option 2: Homebrew 🍺 (macOS/Linux)\n\nThe recommended way for macOS and Linux users:\n\n⚠️ **Beta Release**: This installs the current beta version. Expect potential changes and updates before the stable release.\n\n```bash\n# Add the tap\nbrew tap dawidpereira/quetty\n\n# Install quetty\nbrew install quetty\n\n# Verify installation\nquetty --version\n```\n\n**What you get:**\n\n- ✅ Automatic dependency management\n- ✅ Easy updates with `brew upgrade quetty`\n- ✅ Clean uninstall with `brew uninstall quetty`\n- ✅ Integration with system PATH\n\n#### Option 3: Manual Download 📦\n\nDownload pre-built binaries from [GitHub Releases](https://github.com/dawidpereira/quetty/releases):\n\n**Stable Releases** 🎯 (Production):\n\n- **Download:** \u003chttps://github.com/dawidpereira/quetty/releases/latest\u003e\n- Available for: Linux x64, Windows x64/ARM64, macOS x64/ARM64\n\n**Nightly Builds** 🌙 (Latest features):\n\n- **Download:** \u003chttps://github.com/dawidpereira/quetty/releases/tag/nightly-latest\u003e\n- ⚠️ Warning: May be unstable, not recommended for production\n\n**Manual installation:**\n\n```bash\n# Linux/macOS\ntar -xzf quetty-*-*.tar.gz\nchmod +x quetty-*\nmv quetty-* ~/.local/bin/quetty\n\n# Windows\n# Extract ZIP and move to PATH directory\n\n# Verify checksums\nsha256sum -c checksums.txt\n```\n\n#### Option 4: Build from Source 🔧\n\nFor development or latest unreleased features:\n\n```bash\ngit clone https://github.com/dawidpereira/quetty.git\ncd quetty\ncargo build --release\ncp target/release/quetty ~/.local/bin/\n```\n\n### First Run\n\n#### Interactive Setup (Recommended)\n\n```bash\n# Run the setup wizard\nquetty --setup\n\n# For specific environments, use profiles\nquetty --profile dev --setup      # Development environment\nquetty --profile prod --setup     # Production environment\n```\n\n#### Quick Start\n\n```bash\n# Default profile\nquetty\n\n# Specific profile\nquetty --profile dev\nquetty --profile staging\nquetty --profile prod\n```\n\nOn first launch, Quetty will guide you through the configuration process. For detailed setup instructions, see [INSTALLATION.md](docs/INSTALLATION.md).\n\n### Basic Usage\n\n1. **Configure Authentication**: Set up Azure AD or connection string authentication\n2. **Select Namespace**: Choose your Service Bus namespace\n3. **Pick a Queue**: Select the queue you want to manage\n4. **Start Managing**: Use keyboard shortcuts to navigate and manage messages\n\n\u003e 💡 **Tip**: Press `h` at any time to see available keyboard shortcuts and help.\n\n### Profile Management\n\nQuetty supports multiple profiles for different environments:\n\n```bash\n# Create profiles for different environments\nquetty --profile dev --setup       # Development environment\nquetty --profile staging --setup   # Staging environment\nquetty --profile prod --setup      # Production environment\n\n# Switch between environments\nquetty --profile dev              # Use development profile\nquetty --profile prod             # Use production profile\nquetty                           # Use default profile\n\n# Show configuration directory\nquetty --config-dir              # Shows ~/.config/quetty\n\n# Use custom config file\nquetty --config ./my-config.toml # Custom configuration\n```\n\n## Development\n\nFor development setup and contribution guidelines, see [CONTRIBUTING.md](docs/CONTRIBUTING.md).\n\n### Project Structure\n\n- `ui/` - Terminal user interface (main application)\n- `server/` - Core library for Azure Service Bus integration\n- `themes/` - Built-in themes and theme definitions\n\n## Documentation\n\n### Getting Started\n\n- **[Installation Guide](docs/INSTALLATION.md)** - Setup, profiles, and first-time configuration\n- **[User Guide](docs/USER_GUIDE.md)** - Interface usage and message management\n\n### Reference\n\n- **[CLI Reference](docs/CLI_REFERENCE.md)** - Complete command-line options\n- **[Configuration Reference](docs/CONFIGURATION.md)** - All configuration and authentication options\n\n### Additional Resources\n\n- **[Troubleshooting](docs/TROUBLESHOOTING.md)** - Common issues and solutions\n- **[Contributing](docs/CONTRIBUTING.md)** - Development and contribution guidelines\n\n## Roadmap\n\n### Upcoming Features\n\n- **Binary Releases**: Pre-built binaries for major platforms\n- **Enhanced Bulk Operations**: Improved performance for large-scale operations\n- **Message Templates**: Save and reuse common message patterns\n- **Topic Support**: Full Azure Service Bus Topics and Subscriptions support\n- **Advanced Filtering**: Search and filter messages by content, properties, and metadata\n\n### Recent Additions\n\n- ✅ **Profile-Based Configuration**: Multi-environment support with isolated settings\n- ✅ **Enhanced Security**: Path traversal protection and input validation\n- ✅ **Performance Optimization**: Intelligent caching and reduced filesystem operations\n- ✅ **Complete Authentication Suite**: Device code, client credentials, connection strings\n- ✅ **Bulk Operations**: Multi-message delete, DLQ, and resend operations\n- ✅ **Theme System**: Customizable themes with built-in theme packs\n- ✅ **Message Editing**: Edit and resend messages with validation\n- ✅ **Azure Discovery**: Automatic resource discovery and selection\n\n## Acknowledgments\n\nQuetty is built on the shoulders of amazing open-source projects:\n\n- **[Ratatui](https://github.com/ratatui-org/ratatui)** - A powerful Rust library for building rich terminal user interfaces\n- **[tui-realm](https://github.com/veeso/tui-realm)** - An excellent framework for building stateful TUI applications\n- **[Tokio](https://tokio.rs/)** - The asynchronous runtime for Rust\n- **[Azure SDK for Rust](https://github.com/Azure/azure-sdk-for-rust)** - Azure service integrations\n\nSpecial thanks to the maintainers and contributors of these projects for making terminal-based applications in Rust both powerful and enjoyable to develop.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdawidpereira%2Fquetty","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdawidpereira%2Fquetty","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdawidpereira%2Fquetty/lists"}