# caprica/vlcj

Java framework for the vlc media player

Repository: https://github.com/caprica/vlcj
Canonical: https://ross.abutalabs.com/products/vlcj
Homepage: http://www.capricasoftware.co.uk/projects/vlcj
Language: Java
License: GPL-3.0
License Family: copyleft
Last push: 2026-02-22T21:07:55+00:00

## Health v2 (maintenance only)
Score: 63/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 68, release rhythm 35, longevity 100
- inputs: {"age_days": 5331, "days_push": 192, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1240, forks 263 (observed 2026-08-28T04:04:06.215047+00:00)

## What it is
vlcj is a Java framework providing bindings and a higher-level API for embedding a native VLC media player (via LibVLC) into Java applications. It goes beyond simple bindings by hiding LibVLC complexities, enabling media playback, streaming, and video-on-demand features in Java rich clients.

## Use cases
- embed a video player in a Java Swing or JavaFX application
- play local media files with modern codecs in Java
- build a video-on-demand streaming server in Java
- add audio playback with an equalizer to a Java app
- stream media across a network from a Java application
- build an IPTV or home cinema solution in Java
- generate video thumbnails from Java

## When to choose
- you need robust video/audio playback in Java that JMF or JavaFX cannot handle
- you want to embed VLC's broad codec support in a desktop application
- you need media streaming publish/consume capabilities on the JVM
- you want a higher-level framework rather than raw LibVLC native bindings

## When to avoid
- you need a fully stable release against a production VLC version (vlcj 5.x requires unreleased VLC 4.0 nightly builds)
- you are not on the JVM or cannot ship native VLC libraries
- you need lightweight audio-only playback without native dependencies
- you require permissive licensing, since vlcj is GPL-3.0 (commercial licensing available separately)

## Facets
- artifact type: framework
- maturity: active
- function: video-processing, audio-processing, sdk
- domain: media, desktop-applications, cross-platform
- platform: windows, jvm, cross-platform
- tags: vlc, libvlc, media-player, java-bindings, video-streaming, embedded-player, javafx, swing, linux, macos, desktop

## Member repositories
- caprica/vlcj (main) score 63

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:06.215047+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T05:09:51.785258+00:00, confidence not recorded.
  - readme: https://github.com/caprica/vlcj (fetched 2026-08-28T04:04:06.215047+00:00, sha f97caf501f95)
  - homepage: http://www.capricasoftware.co.uk/projects/vlcj (fetched 2026-08-29T12:20:29.738854+00:00, sha 60a93e4df63b)
- Data as of 2026-08-30T08:39:29.467469+00:00.