Repo brief: kekingcn/kkFileView

Generated by RepoPilot · document generated 2026-09-14 · concise human review Evidence snapshot · analyzed 2026-09-14T20:24:28.608Z · commit dff27aed420b

Verdict

Mixed — Evidence incomplete — review before adopting

• Last commit 1w ago
• 8 active contributors
• CI configured
• Tests present

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests, cross-checked against dependency CVEs from deps.dev and OpenSSF Scorecard

What it is

kkFileView is a Spring Boot–based document preview server that converts and streams 100+ file formats (Office docs, PDFs, CAD models, 3D files, archives, images, audio/video) to browser-renderable formats via REST API. It abstracts file-type detection and conversion pipelines, letting users embed document preview into web apps without installing separate desktop software. Monolithic Spring Boot application with a clear separation: pom.xml at root declares Java 21 + Spring Boot 3.5.6 + multi-module structure (server/ module houses main application logic and embedded LibreOfficePortable/). Docker support via docker/ folder (including kkfileview-base with fonts) enables containerized…

Start here

Open these first:

• pom.xml — Parent Maven POM defining Java 21 target, all module dependencies, and build configuration for the multi-module Spring Boot…
• Dockerfile — Primary Docker image definition for containerized deployment of kkFileView with all preview dependencies.
• docker/kkfileview-base/Dockerfile — Base Docker image layer providing LibreOffice and system libraries required for document conversion and preview.
• README.md — Documents supported file formats (40+ types across Office, PDF, 3D models, email, EPUB) and project scope for preview…
• SECURITY.md — Security policy defining vulnerability reporting and maintenance commitments for a file-handling application.

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

git clone https://github.com/kekingcn/kkFileView.git
cd kkFileView
mvn clean package -DskipTests
mvn spring-boot:run

Expect to verify that Java 21 and Maven 3.6+ are installed. Consult pom.xml and README.md for any additional configuration (database setup, LibreOffice service startup, etc.). Docker alternative: `docker build -f docker…

Daily commands:

mvn clean package -DskipTests
mvn spring-boot:run

Or via Docker: docker build -f docker/kkfileview-base/Dockerfile . && docker run -p 8080:8080 <image_id>. Verify Spring Boot default port 8080 and that LibreOfficePortable service starts correctly. (Exact production c…

…shortened for this brief.

Key cautions & unknowns

• Concentrated ownership — top contributor handles 63% of recent commits
• Scorecard: default branch unprotected (0/10)
• Could not verify license from the available repository evidence
• LibreOffice service initialization: JODConverter requires LibreOfficePortable or a system LibreOffice installation with specific version constraints—verify before running. File upload limits: no visible…
• License evidence is incomplete or ambiguous.
• Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

• Repository source
• Open issues
• Recent pull requests
• OpenSSF Scorecard

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

---

For the complete agent context, use the CLAUDE.md or Cursor rules export.