# Install lunar-date with Homebrew, apt, zypper

Chinese lunar date library. Version 3.2.0 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:lunar-date
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install lunar-date
```

  Evidence: local Homebrew formula metadata

### Linux

- Debian apt (92%):

```sh
sudo apt install gir1.2-lunardate-3.0
```

  Evidence: Debian stable package indexes: gir1.2-lunardate-3.0 from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- zypper (92%):

```sh
sudo zypper install liblunar-date-3_0-1
```

  Evidence: openSUSE Tumbleweed package metadata: liblunar-date-3_0-1 from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst

## Package facts

- **Package key:** brew:lunar-date
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/lunar-date>
- **Version:** 3.2.0
- **Source summary:** Chinese lunar date library
- **Homepage:** <https://github.com/yetist/lunar-date>
- **Repository:** <https://github.com/yetist/lunar-date>
- **Upstream docs:** <https://github.com/yetist/lunar-date#readme>
- **License:** LGPL-2.1-or-later
- **Source archive:** <https://github.com/yetist/lunar-date/releases/download/v3.2.0/lunar-date-3.2.0.tar.xz>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- lunar-date (cli)
- lunar-date (alias)

## Dependencies

- gettext
- glib

## Build dependencies

- meson
- ninja
- pkgconf

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 3.2.0
- Local data: ok
- Upstream repository: https://github.com/yetist/lunar-date
- info: No package-manager update timestamp was available.
- info: No cached GitHub release or tag data was available.
## Project history and usage

LunarDate is a Chinese lunar calendar date library with a C/GObject API, generated API documentation, language bindings, a D-Bus service, and a command-line tool.

### Project history

The GitHub repository was created in January 2013, but its NEWS file preserves an older liblunar lineage with releases from the 0.x, 1.x, and 2.x series. The changelog records the rename from `liblunar`/`lunar-calendar` lineage to `lunar-date` in version 2.4.0, separating the date library from the calendar application.

The 3.0.0 series modernized the project: the API version moved to 3.0, the build system moved to Meson, lunar date data was extended to 2100, GLib became the core dependency, holiday APIs were revised, obsolete APIs were removed, and a D-Bus service plus the `lunar-date` command-line tool were added.

### Adoption history

LunarDate is a niche library, but it is packaged beyond Homebrew: the source facts list Debian and Ubuntu GObject-introspection packages and an openSUSE shared-library package. That footprint reflects its role as a reusable system library rather than an end-user app.

The official API site documents LunarDate 3.0 with library version 3.2.0, GLib and GObject dependencies, headers under `lunar-date/lunar-date.h`, and source links back to GitHub. GitHub releases show maintenance continuing through version 3.2.0 in December 2025.

### How it is used

Developers use LunarDate when they need Chinese lunar calendar calculations from C or GObject-introspection-friendly environments. The README shows Meson build options for documentation, introspection, Vala API generation, tests, and Windows cross-compilation.

The command-line surface is packaged as `lunar-date`, while the library surface is aimed at applications that need calendar conversion, holidays, solar terms, or GLib/GObject integration.

### Why package nerds care

LunarDate matters to package maintainers because it is a small cultural-calendar library with ABI/API versioning, introspection data, Vala bindings, Meson options, Windows cross-build support, and distro package splits. Its history also shows the common open-source transition from a desktop-widget-adjacent library to a narrower reusable system library.

### Timeline

- 2013: Public GitHub repository created.
- 2.4.0: Project renamed to `lunar-date` and split from `lunar-calendar`.
- 2019: 2.9.x releases move away from autotools toward Meson.
- 2021: 3.0.0 releases API 3.0, Meson build, D-Bus service, and `lunar-date` CLI.
- 2025: 3.2.0 release adds legal-holiday information and gi-docgen documentation.

### Related projects

- GLib and GObject are the documented runtime dependencies.
- gi-docgen is used for generated API documentation.
- The NEWS file links the project historically to liblunar and lunar-calendar.

### Sources

- <https://api.github.com/repos/yetist/lunar-date>
- <https://api.github.com/repos/yetist/lunar-date/releases>
- <https://formulae.brew.sh/formula/lunar-date>
- <https://github.com/yetist/lunar-date>
- <https://github.com/yetist/lunar-date/blob/master/NEWS>
- <https://lunar-date.zhcn.cc/>


## Security Notes

library-like package without higher-risk signals.

- **Geiger risk:** green / low
- library-like package without higher-risk signals

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** lunar-date
- **Version Scheme:** 0
- **Revision:** 0
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable

## Other Package-Manager Records

- Debian apt - gir1.2-lunardate-3.0 - 3.0.1-2+b3: normalized package name match | Debian stable package indexes: gir1.2-lunardate-3.0 from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | GObject Introspection for lunar-date | https://github.com/yetist/lunar-date
- Debian apt - liblunar-date-3.0-1 - 3.0.1-2+b3: normalized package name match | Debian stable package indexes: liblunar-date-3.0-1 from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Chinese Lunar library based on GObject | https://github.com/yetist/lunar-date
- Debian apt - liblunar-date-dev - 3.0.1-2+b3: normalized package name match | Debian stable package indexes: liblunar-date-dev from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Chinese Lunar library based on GObject - develop files | https://github.com/yetist/lunar-date
- Debian apt - liblunar-date-doc - 3.0.1-2: normalized package name match | Debian stable package indexes: liblunar-date-doc from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Chinese Lunar library based on GObject - API documents | https://github.com/yetist/lunar-date
- Debian apt - lunar-date - 3.0.1-2+b3: normalized package name match | Debian stable package indexes: lunar-date from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Chinese Lunar library based on GObject - command and D-Bus | https://github.com/yetist/lunar-date
- Ubuntu apt - gir1.2-lunardate-3.0 - 3.0.1-2build3: normalized package name match | Ubuntu 24.04 LTS package indexes: gir1.2-lunardate-3.0 from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | GObject Introspection for lunar-date | https://github.com/yetist/lunar-date
- Ubuntu apt - liblunar-date-3.0-1 - 3.0.1-2build3: normalized package name match | Ubuntu 24.04 LTS package indexes: liblunar-date-3.0-1 from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Chinese Lunar library based on GObject | https://github.com/yetist/lunar-date
- Ubuntu apt - liblunar-date-dev - 3.0.1-2build3: normalized package name match | Ubuntu 24.04 LTS package indexes: liblunar-date-dev from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Chinese Lunar library based on GObject - develop files | https://github.com/yetist/lunar-date
- Ubuntu apt - liblunar-date-doc - 3.0.1-2build3: normalized package name match | Ubuntu 24.04 LTS package indexes: liblunar-date-doc from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Chinese Lunar library based on GObject - API documents | https://github.com/yetist/lunar-date
- Ubuntu apt - lunar-date - 3.0.1-2build3: normalized package name match | Ubuntu 24.04 LTS package indexes: lunar-date from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Chinese Lunar library based on GObject - command and D-Bus | https://github.com/yetist/lunar-date
- zypper - liblunar-date-3_0-1 - 3.0.1-1.8: normalized package name match | openSUSE Tumbleweed package metadata: liblunar-date-3_0-1 from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Chinese Lunar calendar library | https://github.com/yetist/lunar-date
- zypper - lunar-date - 3.0.1-1.8: normalized package name match | openSUSE Tumbleweed package metadata: lunar-date from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Chinese Lunar calendar library | https://github.com/yetist/lunar-date
- zypper - lunar-date-devel - 3.0.1-1.8: normalized package name match | openSUSE Tumbleweed package metadata: lunar-date-devel from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Chinese Lunar calendar library development files | https://github.com/yetist/lunar-date
- zypper - lunar-date-doc - 3.0.1-1.8: normalized package name match | openSUSE Tumbleweed package metadata: lunar-date-doc from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Chinese Lunar calendar library Documents | https://github.com/yetist/lunar-date
- zypper - lunar-date-lang - 3.0.1-1.8: normalized package name match | openSUSE Tumbleweed package metadata: lunar-date-lang from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Translations for package lunar-date | https://github.com/yetist/lunar-date
- zypper - typelib-1_0-LunarDate-3_0 - 3.0.1-1.8: normalized package name match | openSUSE Tumbleweed package metadata: typelib-1_0-LunarDate-3_0 from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Chinese Lunar calendar introspection bindings | https://github.com/yetist/lunar-date


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [gettext](https://www.automicvault.com/pkg/brew/gettext/) - Runtime dependency declared by Homebrew.
- [glib](https://www.automicvault.com/pkg/brew/glib/) - Runtime dependency declared by Homebrew.
- [meson](https://www.automicvault.com/pkg/brew/meson/) - Build dependency declared by Homebrew.
- [ninja](https://www.automicvault.com/pkg/brew/ninja/) - Build dependency declared by Homebrew.
- [pkgconf](https://www.automicvault.com/pkg/brew/pkgconf/) - Build dependency declared by Homebrew.
- [enchant](https://www.automicvault.com/pkg/brew/enchant/) - Shares av.db curated category or tags: c, cli, developer-tools, library.
- [gflags](https://www.automicvault.com/pkg/brew/gflags/) - Shares av.db curated category or tags: c, cli, developer-tools, library.
- [notcurses](https://www.automicvault.com/pkg/brew/notcurses/) - Shares av.db curated category or tags: c, cli, developer-tools, library.
- [gplugin](https://www.automicvault.com/pkg/brew/gplugin/) - Shares av.db curated category or tags: cli, developer-tools, glib, gobject, library.
- [json-glib](https://www.automicvault.com/pkg/brew/json-glib/) - Shares av.db curated category or tags: c, cli, developer-tools, glib, library.
- [libdazzle](https://www.automicvault.com/pkg/brew/libdazzle/) - Shares av.db curated category or tags: cli, developer-tools, glib, gobject, library.
- [libvterm](https://www.automicvault.com/pkg/brew/libvterm/) - Shares av.db curated category or tags: cli, developer-tools, library.
- [tre](https://www.automicvault.com/pkg/brew/tre/) - Shares av.db curated category or tags: cli, developer-tools, library.
- [vala-language-server](https://www.automicvault.com/pkg/brew/vala-language-server/) - Local package facts share a topical domain. Shared terms: cli, developer, developer-tools, gettext, glib.
- [valabind](https://www.automicvault.com/pkg/brew/valabind/) - Local package facts share a topical domain. Shared terms: cli, developer, developer-tools, gettext, glib.
- [cutter-cli](https://www.automicvault.com/pkg/brew/cutter-cli/) - Local package facts share a topical domain. Shared terms: c, cli, developer, developer-tools, gettext.

## Combined YAML source

View the package source record on GitHub. [combined/lunar-date.yml](https://github.com/automic-vault/db/blob/main/combined/lunar-date.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
