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)
