https://github.com/myterminal/see-link

A tool to simplify working with external displays on Linux
https://github.com/myterminal/see-link

common-lisp linux lisp x11 xrandr xserver

Last synced: 14 days ago
JSON representation

A tool to simplify working with external displays on Linux

• Host: GitHub
• URL: https://github.com/myterminal/see-link
• Owner: myTerminal
• License: mit
• Created: 2023-05-30T16:22:06.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-11-01T14:23:56.000Z (3 months ago)
• Last Synced: 2024-11-16T12:28:11.545Z (3 months ago)
• Topics: common-lisp, linux, lisp, x11, xrandr, xserver
• Language: Common Lisp
• Homepage:
• Size: 20.5 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# see-link

[![Built with Lisp](https://img.shields.io/badge/built%20with-Lisp-blueviolet)](https://lisp-lang.org)

[![License](https://img.shields.io/github/license/myTerminal/see-link.svg)](https://opensource.org/licenses/MIT)  

[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/Y8Y5E5GL7)

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](https://www.sbcl.org). 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](https://www.x.org/releases/X11R7.5/doc/man/man1/xrandr.1.html), and that also implies that currently , *see-link* only works on [Xorg](https://www.x.org).

## To-do

* Support for more orientations

* Live connect-disconnect

* Remember devices and their last used orientation