amidaware / community-scripts

A curated list of powershell, python, and batch scripts for use in TacticalRMM or anywhere!

community-scripts

This is a list of powershell, python, and batch scripts for use in TacticalRMM

See https://docs.tacticalrmm.com/contributing_community_scripts/ for best practices on committing.

scripts_wip folder

The /scripts_wip/ is a collection box for anything you want WIP=(Work In Progress). Jot ideas, not completed scripts, all commits welcome. Have some time and want to help with Tactical RMM? Discuss in the #script Discord channel and toss around ideas with other people and improve scripts from wip to official script quality.

scripts_staging folder

The /scripts_staging/ is a collection box for WIP scripts that are believed to be ready for official "Community Scripts" integration. Please test these scripts, and provide feedback on the quality of the script in the Discord #scripts channel.

scripts folder

The /scripts/ folder is the Official Community Script folder. Everything in here will be distributed with Tactical RMM during the install process.

Everything in this folder MUST have a corresponding and valid entry in the community_scripts.json which is used in TRMMs install and upgrade process to integrate these scripts into the Tactical RMM Script Manager > Community Scripts in all Tactical Installations.

Until v1 of Tactical RMM is released function changes on existing scripts is allowed, but not encouraged. Be aware there may be Tactical RMM installs in the field where you might be breaking someones scripts/tasks applied to their workstations. Work hard and try to add additional functionality/consolidate multiple scripts while preserving backwards functionality (or make a new version of the script).

Running tests locally

Setup the env and install pytest

python3 -m venv env
source env/bin/activate
pip install --upgrade pip
pip install -r requirements.txt

Run tests

pytest

Develop using Docker

Download and install Task into your path (or current directory). Run task --list to list available tasks. Run task <task-name> --summary to generate a summary of the commands Task will run. Run task dev-python to develop Python scripts in Docker. Run task dev-powershell to develop PowerShell scripts in Docker.

Note: The --interactive flag was introduced in [Docker compose version v2.3.0][].

$ task --list
task: Available tasks for this project:
* dev-powershell:                   Use Docker compose for development of PowerShell scripts
* dev-python:                       Build and run Python in Docker to develop Python scripts
* dev-python-build:                 Build the Docker image to develop Python scripts
* dev-python-compose-run:           Use Docker compose for development of Python scripts