This repository has been archived on 2025-01-14. You can view files and clone it, but cannot push or open issues or pull requests.
2024-03-23 20:01:15 -05:00
2023-09-16 21:52:24 -05:00
2023-09-17 02:33:22 +00:00
2024-03-23 20:01:15 -05:00

Messagearr

Add new movies to your Radarr library through text messages, and check on their download status. Plus, allow users to create temporary Jellyfin accounts that will automatically delete themselves, allowing your friends to watch and request movies without having to manually dp anything.

Hosting Instructions

Note: No matter if you choose Docker or bare metal to run Messagearr, you will need to follow the same "Configuration" instructions.

Docker

Use the following docker-compose.yaml file to run the container

version: '3.3'
services:
    messagearr:
        ports:
            - '4545:4545'
        volumes:
            - '/loca/file/path:/data'
        image: packetparker/messagearr:latest

Bare metal

Download the latest version of Messagearr, install the requirements from the requirements.txt file and run the wsgi.py file.

Configuration

On the first run, Messagearr will exit and print out and error statement, it will also automatically create a config.ini file for you, with the necessary fields.

Note: Some fields may not be created on the first run. For example, if you choose to enable the Uptime Kuma notifications, the configuration fields for that feature will only be added after you set the field to true and then re-run Messagearr

An explanation of the each configuration field can be found below

Field Description Requirement
SMS_SERVICE The service for your messaging API (only twilio/telnyx currently supported) REQUIRED
RADARR_HOST_URL URL for your Radarr instance REQUIRED
RADARR_API_KEY API key from Radarr (can be created in Settings > General) REQUIRED
API_NUMBER Phone number from your messaging service that will be sending/recieving messages REQUIRED
VALID_SENDERS Comma separated list of phone numbers (international format) that are authorized to use your Messagearr instance REQUIRED
ROOT_FOLDER_PATH Path for the root folder of Radarr (found in Settings > Media Management) REQUIRED
QUALITY_PROFILE_ID ID for the quality profile on Radarr (in order to get a list of your quality profiles and their IDs, set the other fields first, then re-run Messagearr, the config.ini file will update with this information) REQUIRED
ENABLE_KUMA_NOTIFICATIONS True/False : Whether or not to send Uptime Kuma notifications REQUIRED
ENABLE_JELLYFIN_TEMP_ACCOUNTS True/False : Whether or not to enable the Jellyfin temp accounts feature REQUIRED
HOME_DOMAIN Home domain to redirect to if a user sends a GET request to a POST only route OPTIONAL

If you use Twilio for your messaging service, these fields will also be required

Field Description Requirement
TWILIO_ACCOUNT_SID The account SID for your Twilio account REQUIRED
TWILIO_AUTH_TOKEN The auth token for your Twilio account REQUIRED

If you use Telnyx for your messaging service, this field will also be required

Field Description Requirement
TELNYX_API_KEY The API key for your Telnyx account REQUIRED

If you choose to enable Uptime Kuma notifications, these fields will also be required

Field Description Requirement
AUTHORIZATION_HEADER_TOKEN Token used to authorize requests from Uptime Kuma - follow the "Uptume Kuma Setup" instructions further down this page REQUIRED
NOTIF_RECIEVERS Comma separated list of phone numbers (international format) that will recieve text messages from Uptime Kuma REQUIRED

If you choose to enable the Jellyfin temp accounts features, these fields will also be required

Field Description Requirement
JELLYFIN_URL The URL of your Jellyfin instance REQUIRED
JELLYFIN_API_KEY The API from Jellyfin (can be created in Dashboard > API Keys) REQUIRED

Uptime Kuma Setup

If you choose to enable the Uptime Kuma notifications, you will

Description
Add movies to your Radarr library through text messages.
Readme Unlicense 80 KiB
Languages
Python 99.4%
Dockerfile 0.6%