Skip to content

rickysrc/between-spaces

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

48 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MIT License


Logo

Between Spaces

Move between desktop spaces from your phone
Download · Report Bug · Request Feature

Table of Contents

  1. About The Project
  2. Getting Started
  3. Usage
  4. License
  5. Contact
  6. Acknowledgements

About The Project

Between Spaces is an app prototype that allows you to move between desktop spaces with your phone.

Between Spaces Screen Shot

This app runs on a local server that can be accessed by a phone with a QR code or the link displayed in the app. Once the link is open, few buttons will show on screen to send keyboard shortcuts to the OS.

The default shortcuts to move between spaces are:

  • Move left - ctrl + "left"
  • Move right - ctrl + "right"
  • Mission control - ctrl + "up"

The buttons send a GET request to the local server that will trigger KBM-Robot sending the keyboard shortcuts to the OS.

Shortcuts can be added or removed by modifying the endpoints available on server.js and client/index.html

Built With

Getting Started

Java is required to run this app

Prerequisites

  • MacOS
  • A smartphone / tablet

Software

  • NodeJS
  • Java

Installation

  1. Clone the repo
    git clone https://github.com/rico157/between-spaces.git
  2. Install NPM packages
    npm install
  3. Run the app
    npm start

Usage

  • Run the app
  • If you receive an alert, grant the app access to your Mac otherwise choose Apple menu > System Preferences, click Security & Privacy, click Privacy, click Accessibility, then select VSCode and Java tickboxes - Apple.com
  • Click on the system tray icon to show a QR code OR the link with the IP address followed by the PORT eg. IP --> 192.168.0.0:8080 <-- PORT
  • Scan the QR code OR visit the link from your phone
  • Enjoy!

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.

Contact

LinkedIn Twitter Portfolio

Acknowledgements