Git Product home page Git Product logo

zq's Introduction

zq

Easy Zoom queueing.

Some meeting waitlists are confusing and isolating for those waiting for help, but this queueing app makes it easy to immediately bring everyone into Zoom where they will see a welcome message and precise wait times. Depending on how you will use zq, you might find this short guide on how to open multiple Zooms helpful (the guide uses Windows but it also works for Macs and possibly Linux).

demo gif

zq.intro.mp4

features

  • Simple controls with a smart queue. The timers automatically pause, unpause, or reset in many situations when they should.
  • A sound notifies you when a timer has run out.
  • Names and wait times are saved automatically so the app can be restarted any time if needed.
  • Many intuitive keyboard shortcuts (see below), but you will probably only need a few of them.
  • A clean look. No buttons on screen means no confusion for guests.
  • Add style and color. In the settings you can change text style with HTML tags or like this: [b]this will be bold[/b] and [u]this will be underlined[/u], and you can change the color using hex color codes like this: [#00ff00]this text will be green[/], [#fa1a1a]this will be bright orange[/].

download

Windows users, click here to download zq.

Mac and Linux users can use the app by downloading and running the source code following the instructions below.

installing from source

  1. Install Python 3.10 if you haven't already.
  2. Use git clone https://github.com/wheelercj/zq.git where you want the project's folder to appear and cd into the new folder.
  3. Use pip install -r requirements.txt to install the app's dependencies.
  4. Run the app with py src/zq or python3 src/zq.

keyboard shortcuts

  • h toggles keyboard shortcut help.
  • @ shows info about this app.
  • + or - to increase or decrease font size.
  • o opens the settings.
  • a allows you to enter a student's name to add them to the queue.
  • n brings the next student to the front of the queue, and rotates the previously front student to the end.
  • z undoes the previous n keypress.
  • ! removes the last student in the queue.
  • ? removes a student from the queue by name.
  • b adds a 5-minute break to the end of the queue.
  • $ randomizes the order of the queue.
  • m toggles the meeting mode between group and individual meetings.
  • home changes the meeting mode to display a message saying tutoring hours will start soon.
  • end changes the meeting mode to display a message saying tutoring hours will soon end.
  • k or space pauses/unpauses the individual meetings timer.
  • j adds 5 seconds to the individual meetings timer.
  • l subtracts 5 seconds from the individual meetings timer.
  • left arrow adds 30 seconds to the individual meetings timer.
  • right arrow subtracts 30 seconds from the individual meetings timer.
  • r resets the individual meetings timer.
  • d allows you to change the individual meetings duration (in minutes).
  • Ctrl/Cmd+w closes the app.
  • F11 toggles fullscreen.

zq's People

Contributors

wheelercj avatar

Watchers

 avatar

zq's Issues

Selecting styled and/or colored text can spread that style and/or color to all future appended text

Describe the bug
Colored and/or styled text that is selected has a chance of spreading its color and/or style to other text. If the selection ends on the part of the text that is colored and/or styled, and the QTextBrowser is cleared and appended to multiple times, the style and/or color will spread.

Steps to reproduce the behavior:

  1. In zq, select some text with color and/or style, with the selection ending on the part with color and/or style.
  2. Change the window to show different text (e.g. if text in the welcome message was selected, open the help message).
  3. Switch the text back to show the previous message (e.g. if the help message was opened, switch back to the welcome message).
  4. See that the entire welcome message's color and/or style may have changed.

Expected behavior
The color and/or style should not spread.

Screenshots
zq_drag_bug

Additional context

  • OS: Windows
  • zq version 0.3.0 commit d2f2924
  • pyside6==6.3.0

[Won't fix] Randomized breaks can be longer than they're supposed to be

Describe the bug
If at least one person and a short break are in the queue, the option to randomize the order of the queue is used, and the break ends up first, the break may be longer than it is supposed to be.

To Reproduce
Steps to reproduce the behavior:

  1. Add a name to the queue.
  2. Add a break to the queue.
  3. Randomize the order of the queue until the break is first.
  4. See that the wait time is too long.

Expected behavior
The timer could automatically adjust to the correct time just like it does when a break ends up anywhere besides the first spot in the queue.

Screenshots
image

  • OS: Windows
  • zq v0.3.0

Additional context
I'm not planning on fixing this because the user can just reset the timer.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.