Code Monkey home page Code Monkey logo

pie-menus's Introduction

Pie

there is still a lot to do in pie menus, go easy on it, and keep an eye on updates. πŸ˜‰

What is Pie Menus

Blender like pie menus for windows, (blender is free 3d software), its not limited or confined to app, you can set up pie menus for any app or window on your system.

Pie Menus allow you to improve your workflow, you can use it to launch applications, simulate long hotkeys, open URLs, open favourite file folder locations, run other python scripts which automates repetitive tasks and navigate browsers, explorers and windows much faster. It’s very powerful tool once mastered, which is fairly easy. It also has submenus, which is like another pie menu inside a pie menu, you also bind different task on scroll wheel for menu, like volume or brightness control.

Pie Menus are somewhat like context menu, but instead of showing a menu with options in a listed manner, pie menus shows the option in a circle around the mouse cursor. In case you don't know what context menu are, the menu that pop up when you right click on desktop, or on a file, or on some selected text is called context menu. You can check out some screenshots below as to how pie menus look like.

Note: Pie menus are designed to be used in with combination of keyboard and mouse (not trackpad), although with the use trigger keys (a feature in pie menus) you can eliminate the use of mouse in some cases, which is still efficient but definitely not the best. Triggers keys are there for times when you don't have your any hand on mouse and don't want to take your hand off keyboard or don't want to reach the mouse at all.

How to use Pie Menus πŸ–±

The Pie menus will pop up when you press an assigned hotkey, once open you can select an menu/option in it using mouse.

There are two ways to use:

  • You press the hotkey normally (press and let go), the pie menus will open and stay until a menu is selected or the pie menu is cancelled using 'esc' or right click. To activate a menu, select using hovering mouse near it, and pressing left click (lifting left click will activate the selected menu).
  • Pressing and holding down the hotkey, the pie menus will stay open until the held hotkey is released, when releasing the hotkey, the selected menu will automatically get activated, there is no need for left click, just hover on the menu to activate and release the hotkey. Using this mode which I like to call marking mode (from Autodesk Maya), you can speed up your workflow significantly. It will feel just like drawing gesture using mouse. After a few usage of it, you can also do it with your eyes closed as your muscle memory will remember which way to flick the mouse to activate certain menu. and yes in marking mode also pie menu can be cancelled using 'esc' or right click.

Quick Getting Started : After installing and running, go to desktop and press tilde key ` on keyboard to call a pie menu.

List of stock Pie Menus: Yet to be documented.

List of stock themes: Yet to be documented.

Installation

Download the latest release from the releases tab, and Install just like any other windows app/software.

To disable it to run with windows boot, you can open task manager, go to startup tab, select pie menus and disable it. same to enable it again.

Features

  • Multi monitor support.
  • High DPI support, can be used on 4k monitors.
  • Sub Menus - Marking Menus (kind of like pie Menus inside pie Menus)
  • Smooth Animations & Transitions.
  • Multiple themes, can be set different of different menus.
  • Scroll wheel action on menus
  • Trigger keys when you are lazy and don't want to reach mouse.
  • Maya like tracking line, Blender like tracking slice.

System Requirements

Any windows 10 - 64 bit.

Not tested on 32 bit, although should work fine. Let me know if anyone tests it on a 32 bit machine, whether it works fine or have issues.

Screenshots

Pie Menus screen shots

Pie Menus screen shots

Create your own Pie Menus

Yet to be documented. Sorry. Please edit appProfiles.json.

A Special Thanks ❀❀❀

A very special thanks to Beau Gills for his marvellous work AutoHotPie, He in the first place created pie menus for windows using Autohotkey scripting language, Its just awesome and mind blowing how much effort he has put into it. For days I was searching for pie menus for windows and it was the only project I found after too many google searches and it changed everything. I must admit that this project wouldn't be here how it is without Beau. My heartful thanks to him ❀😊.

Feature request, Bugs and Issue reporting

More features coming soon, if you have any feature request, you can create a new issue for it.

How to run from source code

  • Clone the repo or download as zip. git clone https://github.com/Himanshu-Singh-Chauhan/Pie-Menus.git
  • install python v3 or above, version I use during development is v3.9.4 and a bunch of packages which are stored in pip_requirements.txt and can be installed from following command.
		pip install -r /resources/pip_requirements.txt
  • run "main.py" directly or from any code editor
  • to exit app, exit from hidden icon in tray

How to Contribute

Any contributions you make are most welcome and are greatly appreciated.

  1. Clone repo and create a new branch: git checkout https://github.com/Himanshu-Singh-Chauhan/Pie-Menus -b name_for_new_branch.
  2. Make changes and test
  3. Submit Pull Request with comprehensive description of changes

You can contribute new set of Pie Menus which can be useful to most people, or new theme.

The set of pie menus contributed should be available with appprofile, should be disabled by default, document it properly, and should use the default theme.

DO NOT submit a menu which is very very specific to your workflow which may not work on other's system.

Acknowledgements / Attributions

Additional Information


want to Support the project

Donation Link to Buy Me a Coffee

Hits

pie-menus's People

Contributors

himanshu-singh-chauhan avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar

pie-menus's Issues

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.