Giter Club home page Giter Club logo

winjump's Introduction

image

Configure a custom keyboard shortcut to jump between virtual desktops in Windows.

Features:

  • Configure a custom keyboard shortcut (like alt + N or win + N) to jump directly to a virtual desktop
  • See what virtual desktop you're currently on in the system tray:

image

  • Group virtual desktops together and cycle through them with a custom shortcut key
  • Configure a shortcut to jump back and forth between two virtual desktops
  • Move applications to a specific desktop with a shortcut
  • Scroll with your mouse over the taskbar to quickly navigate between virtual desktops

Installation

  1. Download

Note, you may receive a Windows smartscreen warning when you try to run WinJump. Click "More options" and click "Run anyway"

  1. Press Ctrl+R and type shell:startup
  2. Drag the WinJump.exe to the shell startup folder
  3. Double click WinJump.exe to run it

Config file

To configure WinJump, right click the system tray icon and select "open config file":

image

Syntax

There are three blocks:

  • toggle-groups let you group desktops together and cycle through them with a keyboard shortcut
  • jump-current-goes-to-last lets you decide whether jumping to the desktop you're already on does A) nothing or B) goes to your previous desktop
  • jump-to lets you define shortcuts that jump directly to a desktop
  • move-window-to-desktop lets you specify a custom shortcut modifier. When pressed, the currently focused window will be moved to the desktop specified by the number key you press.
  • change-desktops-with-scroll should desktops automatically switch by scrolling over the taskbar?

The toggle-groups and jump-to blocks contain a list of items, each item has a shortcut property. This shortcut must be a combination of: win, alt, shift, and ctrl, it must be terminated by a key listed here, and each token must be separated by +.

Each toggle-groups item has the desktops property, which should be a list of positive integers, with 1 representing the first desktop.

Each jump-to item has the desktop property, which should be a single positive integer, with 1 representing the first desktop.

⚠️ If no .winjump config file is found or a syntax error exists within it, WinJump will use default key mappings.

⚠️ WinJump does not auto-reload your configuration file. To apply changes, right click the system-tray icon and select Reload configuration.

Example

Below is an example configuration file that changes the shortcut to alt+N to jump to a desktop and adds a toggle group that is triggered by alt+w that will cycle between desktops 1, 5, and 6:

// C:\Users\<UserName>\.winjump
{
  "toggle-groups": [
    {
      "shortcut": "alt+w",
      "desktops": [ 1, 5, 6 ]
    }
  ],
  "jump-current-goes-to-last": false,
  "move-window-to": [
    {
      "shortcut": "alt+shift+d1",
      "desktop": 1,
      "follow": false
    },
    {
      "shortcut": "alt+shift+d2",
      "desktop": 2,
      "follow": false
    },
    {
      "shortcut": "alt+shift+d3",
      "desktop": 3,
      "follow": false
    },
    {
      "shortcut": "alt+shift+d4",
      "desktop": 4,
      "follow": false
    }
  ],
  "change-desktops-with-scroll": false,
  "jump-to": [
    {
      "shortcut": "alt+d1",
      "desktop": 1
    },
    {
      "shortcut": "alt+d2",
      "desktop": 2
    },
    {
      "shortcut": "alt+d3",
      "desktop": 3
    },
    {
      "shortcut": "alt+d4",
      "desktop": 4
    },
    {
      "shortcut": "alt+d5",
      "desktop": 5
    },
    {
      "shortcut": "alt+d6",
      "desktop": 6
    },
    {
      "shortcut": "alt+d7",
      "desktop": 7
    },
    {
      "shortcut": "alt+d8",
      "desktop": 8
    },
    {
      "shortcut": "alt+d9",
      "desktop": 9
    },
    {
      "shortcut": "alt+d0",
      "desktop": 10
    }
  ]
}

Advanced

WinJump uses the reverse engineered Windows virtual desktop API. This means that the API often changes between Windows releases. Please see the reverse engineering guide if you're interested in contributing reverse-engineering definitions for new Windows releases.

Uninstall

  1. Press Ctrl+R and type shell:startup
  2. Delete WinJump.exe

winjump's People

Contributors

widavies avatar philipnelson5 avatar

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.