RHEL/CentOS - A Python based monitoring and tracking tool for Plex Media Server
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
defaults
handlers
meta
tasks
templates
tests
vars
.travis.yml
COPYING
README.md

README.md

ansible-role-tautulli

Build Status Ansible Galaxy License

RHEL/CentOS - A Python based monitoring and tracking tool for Plex Media Server

Requirements

None

Role Variables

tautulli_advanced:
  config_version: 11
  journal_mode: wal
  jwt_secret: ''
  metadata_cache_seconds: 1800
  notification_threads: 2
  pms_timeout: 15
  remote_access_ping_threshold: 3
  session_db_write_attempts: 5
  system_analytics: 1
  verify_ssl_cert: 1
  websocket_connection_attempts: 5
  websocket_connection_timeout: 5

tautulli_cloudinary:
  cloudinary_api_key: ''
  cloudinary_api_secret: ''
  cloudinary_cloud_name: ''

tautulli_general:
  allow_guest_access: 0
  anon_redirect: http://www.nullrefer.com/?
  api_enabled: 1
  api_key: "{{ 'tautulli'|md5 }}"
  api_sql: 0
  backup_days: 3
  backup_dir: /opt/Tautulli/backups
  backup_interval: 6
  cache_dir: /opt/Tautulli/cache
  cache_images: 1
  check_github: 1
  check_github_interval: 360
  check_github_on_startup: 1
  cleanup_files: 0
  date_format: YYYY-MM-DD
  do_not_override_git_branch: 0
  enable_https: 0
  first_run_complete: 0
  freeze_db: 0
  geoip_db: ''
  get_file_sizes: 0
  git_branch: master
  git_path: ''
  git_remote: origin
  git_repo: Tautulli
  git_token: ''
  git_user: Tautulli
  graph_days: 30
  graph_months: 12
  graph_tab: tabs-1
  graph_type: plays
  group_history_tables: 1
  history_table_activity: 1
  home_library_cards:
    - 1
    - 2
  home_refresh_interval: 10
  home_sections:
    - current_activity
    - library_stats
    - recently_added
    - watch_stats
  home_stats_cards:
    - last_watched
    - most_concurrent
    - popular_movies
    - popular_music
    - popular_tv
    - top_movies
    - top_music
    - top_platforms
    - top_tv
    - top_users
  home_stats_count: 5
  home_stats_length: 30
  home_stats_recently_added_count: 50
  home_stats_type: 0
  http_base_url: ''
  http_basic_auth: 0
  http_environment: production
  http_hash_password: 0
  http_hashed_password: 0
  http_host: 0.0.0.0
  http_password: ''
  http_plex_admin: 0
  http_port: 8181
  http_proxy: 0
  http_root: ''
  http_username: ''
  https_cert: /opt/Tautulli/server.crt
  https_cert_chain: ''
  https_create_cert: 0
  https_domain: localhost
  https_ip: 127.0.0.1
  https_key: /opt/Tautulli/server.key
  interface: default
  ip_logging_enable: 0
  launch_browser: 1
  log_blacklist: 1
  log_dir: /opt/Tautulli/logs
  plexpy_auto_update: 0
  show_advanced_settings: 0
  themoviedb_apikey: ''
  themoviedb_lookup: 0
  time_format: HH:mm
  tvmaze_lookup: 0
  update_db_interval: 24
  update_labels: 1
  update_libraries_db_notify: 0
  update_notifiers_db: 0
  update_section_ids: 1
  update_show_changelog: 0
  week_start_monday: 0

tautulli_monitoring:
  buffer_threshold: 3
  buffer_wait: 900
  imgur_client_id: ''
  logging_ignore_interval: 120
  monitor_pms_updates: 0
  monitor_remote_access: 0
  monitoring_interval: 60
  monitoring_use_websocket: 1
  movie_logging_enable: 1
  movie_notify_enable: 0
  movie_notify_on_pause: 0
  movie_notify_on_start: 1
  movie_notify_on_stop: 0
  movie_watched_percent: 85
  music_logging_enable: 1
  music_notify_enable: 0
  music_notify_on_pause: 0
  music_notify_on_start: 1
  music_notify_on_stop: 0
  music_watched_percent: 85
  notify_concurrent_by_ip: 0
  notify_concurrent_threshold: 2
  notify_consecutive: 0
  notify_group_recently_added: 0
  notify_group_recently_added_grandparent: 0
  notify_group_recently_added_parent: 0
  notify_on_buffer_body_text: '{user} ({player}) is buffering {title}.'
  notify_on_buffer_subject_text: 'Tautulli ({server_name})'
  notify_on_concurrent_body_text: '{user} has {user_streams} concurrent streams.'
  notify_on_concurrent_subject_text: 'Tautulli ({server_name})'
  notify_on_created_body_text: '{title} was recently added to Plex.'
  notify_on_created_subject_text: 'Tautulli ({server_name})'
  notify_on_extdown_body_text: 'The Plex Media Server remote access is down.'
  notify_on_extdown_subject_text: 'Tautulli ({server_name})'
  notify_on_extup_body_text: 'The Plex Media Server remote access is back up.'
  notify_on_extup_subject_text: 'Tautulli ({server_name})'
  notify_on_intdown_body_text: 'The Plex Media Server is down.'
  notify_on_intdown_subject_text: 'Tautulli ({server_name})'
  notify_on_intup_body_text: 'The Plex Media Server is back up.'
  notify_on_intup_subject_text: 'Tautulli ({server_name})'
  notify_on_newdevice_body_text: '{user} is streaming from a new device: {player}.'
  notify_on_newdevice_subject_text: 'Tautulli ({server_name})'
  notify_on_pause_body_text: '{user} ({player}) has paused {title}.'
  notify_on_pause_subject_text: 'Tautulli ({server_name})'
  notify_on_pmsupdate_body_text: 'An update is available for the Plex Media Server (version {update_version}).'
  notify_on_pmsupdate_subject_text: 'Tautulli ({server_name})'
  notify_on_resume_body_text: '{user} ({player}) has resumed {title}.'
  notify_on_resume_subject_text: 'Tautulli ({server_name})'
  notify_on_start_body_text: '{user} ({player}) started playing {title}.'
  notify_on_start_subject_text: 'Tautulli ({server_name})'
  notify_on_stop_body_text: '{user} ({player}) has stopped {title}.'
  notify_on_stop_subject_text: 'Tautulli ({server_name})'
  notify_on_watched_body_text: '{user} ({player}) has watched {title}.'
  notify_on_watched_subject_text: 'Tautulli ({server_name})'
  notify_recently_added: 0
  notify_recently_added_delay: 60
  notify_recently_added_grandparent: 0
  notify_recently_added_upgrade: 0
  notify_scripts_args_text: ''
  notify_upload_posters: 0
  notify_watched_percent: 85
  refresh_libraries_interval: 12
  refresh_libraries_on_startup: 1
  refresh_users_interval: 12
  refresh_users_on_startup: 1
  tv_logging_enable: 1
  tv_notify_enable: 0
  tv_notify_on_pause: 0
  tv_notify_on_start: 1
  tv_notify_on_stop: 0
  tv_watched_percent: 85
  video_logging_enable: 1

tautulli_newsletter:
  newsletter_auth: 0
  newsletter_custom_dir: ''
  newsletter_dir: /opt/Tautulli/newsletters
  newsletter_inline_styles: 0
  newsletter_password: ''
  newsletter_self_hosted: 0
  newsletter_static_url: 0
  newsletter_templates: newsletters

tautulli_packages: []

tautulli_plexwatch:
  grouping_charts: 0
  grouping_global_history: 0
  grouping_user_history: 0
  plexwatch_database: ''

tautulli_pms:
  pms_identifier: ''
  pms_ip: 127.0.0.1
  pms_is_cloud: 0
  pms_is_remote: 0
  pms_logs_folder: ''
  pms_logs_line_cap: 1000
  pms_name: ''
  pms_platform: ''
  pms_plexpass: 0
  pms_port: 32400
  pms_ssl: 0
  pms_token: ''
  pms_update_channel: plex
  pms_update_distro: ''
  pms_url: ''
  pms_url_manual: 0
  pms_use_bif: 0
  pms_uuid: ''
  pms_web_url: https://app.plex.tv/desktop

tautulli_provider_notifications:
  Boxcar:
    boxcar_enabled: 0
  Browser:
    browser_enabled: 0
  Email:
    email_enabled: 0
  Facebook:
    facebook_enabled: 0
  Growl:
    growl_enabled: 0
  Hipchat:
    hipchat_enabled: 0
  IFTTT:
    ifttt_enabled: 0
  Join:
    join_enabled: 0
  NMA:
    nma_enabled: 0
  OSX_Notify:
    osx_notify_enabled: 0
  Plex:
    plex_enabled: 0
  Prowl:
    prowl_enabled: 0
  Pushalot:
    pushalot_enabled: 0
  PushBullet:
    pushbullet_enabled: 0
  Pushover:
    pushover_enabled: 0
  Scripts:
    scripts_enabled: 0
  Slack:
    slack_enabled: 0
  Telegram:
    telegram_enabled: 0
  Twitter:
    twitter_enabled: 0
  XBMC:
    xbmc_enabled: 0

tautulli_systemd: {}

Dependencies

Example Playbook

- hosts: servers
  roles:
    - role: linuxhq.tautulli
      tautulli_advanced:
        jwt_secret: b9b66b767c259a72456461bc8d514560
      tautulli_general:
        api_enabled: 1
        api_key: 2ccc9beb14b9dafbe26182915608bebc
        first_run_complete: 1
        geoip_db: /usr/share/GeoIP/GeoLite2-City.mmdb
        git_token: da2292190b84652e70752b87f689836c
        launch_browser: 0
        plexpy_auto_update: 1
        show_advanced_settings: 1
        themoviedb_apikey: 7f5c54be37cb076df57bd820869ca72f
        themoviedb_lookup: 1
        tvmaze_lookup: 1
        update_show_changelog: 1
      tautulli_monitoring:
        imgur_client_id: bbbac4ee13f6306
        notify_upload_posters: 1
      tautulli_newsletter:
        newsletter_inline_styles: 1
      tautulli_packages:
        - geolite2-city
      tautulli_pms:
        pms_ip: 127.0.0.1
        pms_port: 32400
        pms_url: http://127.0.0.1:32400
        pms_web_url: https://app.plex.tv/desktop

License

Copyright (C) 2018 Taylor Kimball tkimball@linuxhq.org

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.