

LDH GUI SUITE


project | code | tracker

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.

Debian

Requirements:

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

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 the
--enable-hub-uri=URI and/or --enable-social-uri=URI options to
configure.


Usage

Hub

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

Social

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


Implementation

Web wrappers are currently implemented as a 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 with 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 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)
