GR360RY.htpc-common

htpc-common

This is an Ansible role for managing common tasks on a Home Theater PC (HTPC).

Overview

Install an SSH server for remote access.
Set up Zeroconf networking and avahi-alias service.
Create a user named htpc_user if it doesn't already exist.
Provide sudo access for the htpc_user.
Create folders for media and downloads.

Folder Structure for Downloads and Media (using default settings):

/mnt/media/
├── downloads
│   ├── complete
│   └── incomplete
├── movies
├── music
├── pictures
└── tv

Requirements

Ansible version 2.0 or higher.

Role Variables

# Default settings for htpc-common

# HTPC user details
htpc_user_username: htpc
htpc_user_password: htpc
htpc_user_group: htpc
htpc_user_shell: /bin/bash
htpc_user_sudo_access: yes

# Services settings
htpc_ssh_service: yes
htpc_create_media_folders: yes
htpc_zeroconf: yes

# Directory paths for media and downloads
htpc_media_path: /mnt/media
htpc_media_movies: movies
htpc_media_tv: tv
htpc_media_music: music
htpc_media_pictures: pictures
htpc_downloads_complete: "{{ htpc_media_path }}/downloads/complete"
htpc_downloads_incomplete: "{{ htpc_media_path }}/downloads/incomplete"

# Variable to configure service resolution
htpc_resolving: zeroconf

# Variable for Docker access
docker_group_members:
  - "{{ htpc_user_username }}"

Dependencies

None

Example Playbook

- hosts: htpc-server
  become: yes

  vars:
    htpc_user_username: foo
    htpc_user_group: foo
    htpc_user_password: bar
    htpc_media_path: /media/big_disk
    htpc_media_movies: "My Movies"

  roles:
    - role: GR360RY.htpc-common