gantsign.pin-to-launcher

Ansible Role: Pin to Launcher

This role helps you pin applications to your desktop launcher.

Requirements

Ansible version 2.9 or higher
Ubuntu versions:
- Bionic (18.04)
- Focal (20.04)
- Other versions may work but they haven't been tested.
A supported launcher:
- Gnome - This is the default desktop for Ubuntu starting with Bionic (18.04).

Role Variables

You can change how this role works by setting these variables (default values are shown):

# Applications to pin
pin_to_launcher_favorites: []

Favorites should be listed like this:

pin_to_launcher_favorites:
  - application: # Name of the .desktop file in /usr/share/applications/

Example Playbook

- hosts: servers
  roles:
    - role: gantsign.pin-to-launcher
      pin_to_launcher: gnome
      pin_to_launcher_favorites:
        # Common apps to pin for Gnome users.
        - application: 'ubiquity.desktop' # Application search/menu
        - application: 'org.gnome.Nautilus.desktop' # File browser
        # Add your favorite applications below
        #
        # Tip: run `gsettings get org.gnome.shell favorite-apps` to check your pinned apps.
        - application: 'firefox.desktop'
        - application: 'thunderbird.desktop'
        - application: 'rhythmbox.desktop'
        - application: 'libreoffice-writer.desktop'

More Roles From GantSign

You can find more roles made by GantSign on Ansible Galaxy.

Development & Testing

This project uses Molecule for help in development and testing; it uses Testinfra and pytest for unit testing.

To develop or test this role, make sure you have the following installed:

Linux (e.g., Ubuntu)
Docker
Python (including python-pip)
Ansible
Molecule

Since installing these can be tricky, this project includes Molecule Wrapper. The Molecule Wrapper is a script that installs Molecule and its requirements (except Linux) and then runs Molecule with the command you provide.

To test this role using Molecule Wrapper, run the following command from the project root: