LDH GUI Suite

project | code | tracker | debian

A Liberty Deckplan Host (LDH) is a single domain
implementing the concrete configuration plan defined
at https://source.puri.sm/liberty/services

This package contains resources for LDH clients. Including:

  - icons for all services and wrappers for web interfaces
  - default configuration for the flagship host librem.one
  - reconfiguration for any other host

Install

If the GUI Suite is not pre-installed on your system,
the preferred installation method is your package manager.
Installing the suite package will install
all recommended clients and their dependencies on your system.

Runtime requirements:

  - GNOME Web (a.k.a. Epiphany) 3.19.1 or newer

Debian

On Debian and derived systems (including Ubuntu and PureOS):

sudo apt install ldh-gui-suite

From source tarball

Build requirements when installing from source:

  - make
  - scour
  - rsvg-convert
  - gtk-update-icon-cache

Installing from source tarball:

./configure
make
sudo make install

From Git snapshot

Additional build requirements when installing from Git snapshot:

  - autoconf 2.69 or newer
  - autoconf-archive 2015-02-05 or newer
  - automake

Installing from Git snapshot:

./bootstrap
./configure
make
sudo make install

Configuration

Consult your distribution how to configure when installing a package.

When installing from source, you can customize
which Liberty Deckplan Host to use,
by passing the --enable-domain=DOMAIN option to configure.

Alternatively you can freely define the full URIs to use,
by passing either of the options --enable-hub-uri=URI,
--enable-chat-uri=URI, or --enable-social-uri=URI to configure.

Usage

Hub

  - Click on the Hub icon to launch.
  - Enter your credentials.
  - Manage your account.

Chat

  - Click on the Chat icon to launch.
  - Enter your credentials.
  - Start chatting!

Social

  - Click on the Social icon to launch.
  - Enter your credentials.
  - Start posting!

Implementation

Web wrappers are currently implemented as GNOME Web applications,
configured by debconf. See
How do I define a system-wide web application?
(GNOME Web FAQ) for details.

This implementation should work on any Debian-based distribution that
includes GNOME Web.

Host compatibility

Clients should work on any host that follows the Liberty Deckplan.
For example, any social server with the domain social.example.com
and which supports /web/getting-started as a login path. The latter
includes any Smilodon, Mastodon or Florence instance.

Sharing and contributions

LDH GUI Suite
https://source.puri.sm/liberty/ldh_gui_suite
Copyright 2019-2020, Jonas Smedegaard dr@jones.dk
Copyright 2019-2020, Purism, SPC
SPDX-License-Identifier: AGPL-3.0-or-later

Shared under AGPL-3.0-or-later. We adhere to the Community Covenant
1.0 without modification, and certify origin per DCO 1.1 with a
signed-off-by line. Contributions under the same terms are
welcome.

For details see:

  - COPYING.AGPL.md, full license text
  - CODE_OF_CONDUCT.md, full conduct text
  - CONTRIBUTING.DCO.md, full origin text (git -s)
