Skip to content

A tool to simplify working with external displays on Linux

License

Notifications You must be signed in to change notification settings

myTerminal/see-link

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

see-link

Built with Lisp License
ko-fi

A tool to simplify working with external displays on Linux

Installation

There are a few different ways to get see-link.

Compile from source

# Clone project to the local workspace
git clone https://github.com/myTerminal/see-link.git

# Switch to the project directory
cd see-link

# Install with `make`
make install

Automatic installation

Simply execute the below command in a terminal; the rest should be automatic.

/bin/bash -c "$(curl https://raw.githubusercontent.com/myTerminal/see-link/main/install)"

Through a package manager

see-link will soon be available to install from your operating system's package manager.

How to Use

A simple way to use see-link is to run it in a command-line terminal passing specifying whether you need to connect or disconnect external displays.

see-link connect

By default, any available external display(s) will be attached to the left of the primary device. You can also optionally specify whether you'd like to attach the displays to the left or to the right.

see-link connect right

The above command would connect external displays to the right of the primary device.

In order to disconnect, simply run the below command.

see-link disconnect

The behavior in absence of any arguments is as follows:

  1. When external display devices are available, a connect operation is performed
  2. When no external display device is connected, a disconnect operation is performed

Further help with commands

To learn more about usage, refer to manpage:

man see-link

Updating

In order to update see-link, simply run:

see-link-update

Uninstalling

In order to uninstall see-link, simply run:

see-link-uninstall

External Dependencies

Being written with Common Lisp, see-link depends on SBCL. In most cases, it will be automatically installed while generating the binary, but if it doesn't please install it before running the installation.

The other required programs are as follows:

  • xrandr, and that also implies that currently , see-link only works on Xorg.

To-do

  • Support for more orientations
  • Live connect-disconnect
  • Remember devices and their last used orientation

About

A tool to simplify working with external displays on Linux

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published