mirror of https://github.com/Radarr/Radarr synced 2026-01-23 16:04:18 +01:00

[WIP] Fix open issues after research and analysis (#110 )

* Initial plan

* feat(ci): Add secret scanning with secretlint to pre-commit hooks

- Install secretlint and @secretlint/secretlint-rule-preset-recommend
- Configure secretlint with .secretlintrc.json
- Add secretlint to lint-staged configuration
- Update CONTRIBUTING.md to document secret scanning
- Resolves #55

Co-authored-by: cheir-mneme <176430037+cheir-mneme@users.noreply.github.com>

* feat(privacy): Disable telemetry and analytics by default

- Set SentryEnabled to false by default in SentryTarget
- Update English localization to clarify error reporting is opt-in
- Update README with detailed privacy information
- Machine fingerprinting already removed (returns "anonymous")
- Piwik analytics already removed
- AnalyticsEnabled defaults to false in config

This ensures no telemetry is sent without explicit user consent.

Resolves #8

Co-authored-by: cheir-mneme <176430037+cheir-mneme@users.noreply.github.com>

* refactor: Address code review feedback for pre-commit and telemetry changes

- Optimize secretlint to only scan relevant file types (not all files)
- Add ignoreFiles configuration to secretlint to exclude build artifacts
- Clarify comment in SentryTarget about reconfiguration location

Co-authored-by: cheir-mneme <176430037+cheir-mneme@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: cheir-mneme <176430037+cheir-mneme@users.noreply.github.com>

2025-12-21 14:19:46 -06:00

3.2 KiB

Raw Blame History

Aletheia

All-in-one media manager for movies, books, and audiobooks.

Overview

Aletheia (from Greek ἀλήθεια - "truth, disclosure") is a unified media management system forked from Radarr. It provides automated monitoring, downloading, and library management for multiple media types through a single interface. It's an ambitious attemp to merge much of the functionality of the arr apps. This, in addition to many personal feature requests, QoL improvements, and privacy/security updates.

Current Status: Active development. Movie functionality inherited from Radarr is working. Multi-media foundation being implemented.

Features

Movies (working):

Automated monitoring and quality upgrades
Metadata and artwork management
Integration with download clients and indexers

Books (in development):

EPUB, MOBI, PDF quality tracking
Author and series hierarchy
Goodreads/Hardcover metadata

Audiobooks (in development):

M4B, MP3, etc. support
Narrator tracking
Duration metadata and Audible integration

General:

Usenet and BitTorrent support
SABnzbd, NZBGet, qBittorrent, Deluge, rTorrent, Transmission integration
Plex and Kodi integration
Built-in archive extraction (Unpackerr functionality)

Privacy

Telemetry and analytics are disabled by default:

No usage analytics or behavior tracking
No machine fingerprinting or unique identifiers
Error reporting (Sentry) is opt-in
Update checks only send version and platform info (no personal data)

To enable error reporting for troubleshooting, toggle Analytics in Settings → General.

What data is collected if you opt-in:

Anonymous error reports via Sentry (stack traces, OS version, app version)
No personally identifiable information is ever collected

Quick Start

docker run -d \
  --name=aletheia \
  -e PUID=1000 \
  -e PGID=1000 \
  -p 7878:7878 \
  -v /path/to/config:/config \
  -v /path/to/media:/media \
  --restart unless-stopped \
  ghcr.io/cheir-mneme/aletheia:latest

Web interface: http://localhost:7878

Building from Source

Requirements: .NET 8.0 SDK, Node.js 20+, Yarn

git clone https://github.com/cheir-mneme/aletheia.git
cd aletheia
./build.sh --backend --frontend
dotnet run --project src/Radarr

Roadmap

See ROADMAP.md for detailed phase planning.

Completed:

Phase 0-1: Privacy & security fixes
Phase 2: Foundation (fork, CI/CD, branding)
Phase 2.5: Community standards, quality gates, Unpackerr absorption

Current:

Phase 3: Multi-media foundation (database generalization, indexer management)

Planned:

Phase 4: Books & audiobooks support
Phase 5: TV shows
Phase 6: Music (with fingerprinting and quality analysis)
Phase 7: Subtitles (Bazarr replacement), podcasts, comics

Contributing

See CONTRIBUTING.md for development setup, code guidelines, and PR process.

Development standards:

Conventional commits (feat:, fix:, docs:, etc.)
Feature branches + PRs to develop
Pre-commit hooks for linting

License

GNU GPL v3

3.2 KiB Raw Blame History