[ SECURITY ]

Security
Policy

Responsible disclosure, security guidelines, and how we handle vulnerability reports for UMD.

Apache 2.0 Licensed
Open Source · No Telemetry
[ POLICY ]

Our Security Commitment

UMD is an open-source CLI tool. We take security seriously and appreciate responsible disclosure from the community.

This document outlines how to report vulnerabilities, what we consider in scope, and what you can expect from us when you report an issue.

[ REPORTING ]

Reporting a Vulnerability

If you discover a security vulnerability in UMD, please report it responsibly. Do not open a public GitHub or Codeberg issue for security vulnerabilities.

Send your report to the maintainer privately via Codeberg's private issue tracker or direct message. Include as much detail as possible: steps to reproduce, potential impact, and any suggested fixes.

01Go to the UMD repository on Codeberg
02Use the private/confidential issue feature if available
03Or DM the maintainer @nk2552003 directly
04Include a clear description and reproduction steps
05Wait for acknowledgment (within 72 hours)
[ SCOPE ]

What Is In Scope

We are interested in vulnerabilities that could affect users of UMD or the security of the project itself.

Remote code execution via malicious URLs or inputs
Path traversal or arbitrary file write vulnerabilities
Dependency vulnerabilities in direct dependencies (yt-dlp, ffmpeg wrappers)
Authentication or credential exposure in configuration files
Supply chain attacks or compromised dependencies
Privilege escalation during installation scripts
[ OUT OF SCOPE ]

What Is Out of Scope

The following are generally not considered security vulnerabilities in the context of UMD:

Downloading copyrighted content (this is a user responsibility)
Rate limiting or throttling by third-party platforms
Issues in yt-dlp itself (report those upstream)
Social engineering or phishing attacks not related to UMD
Vulnerabilities in user's own Python/OS environment
Missing best practices without a demonstrated exploit
[ BEST PRACTICES ]

Security Guidelines

Never share credentials

UMD does not collect, store, or transmit any of your credentials. Spotify and other platform tokens are stored locally only.

Review install scripts

Always review install.sh or install.bat before running. The scripts are open-source and available for inspection on Codeberg.

Keep dependencies updated

Run pip install -e . periodically to pull the latest secure versions of all dependencies, especially yt-dlp.

72-hour response SLA

We commit to acknowledging security reports within 72 hours and providing a fix timeline within 7 days for critical issues.

Coordinated disclosure

We ask that reporters give us at least 90 days to patch a vulnerability before public disclosure.

No bounty program

UMD is a solo open-source project. While we cannot offer monetary bounties, we will credit all responsible disclosures in the changelog.

[ CONTACT ]

Found something?

Report it responsibly. We read every report and respond to all legitimate security concerns.

Report on Codeberg ↗