Futbol Libre Hoy

List today's football fixtures and live scores from Futbol Libre right in your terminal or app.

futbol-libre-hoy is a small, dependency-free client and CLI for the public matchday calendar feed. It fetches the day's fixtures, formats scores, filters live games, and groups matches by competition.

Install

npm install futbol-libre-hoy
# or run without installing
npx futbol-libre-hoy

CLI

npx futbol-libre-hoy                     # today's fixtures
npx futbol-libre-hoy --live              # only live matches
npx futbol-libre-hoy --date 2026-08-09   # a specific day (YYYY-MM-DD)
npx futbol-libre-hoy --json              # raw JSON output

| Flag | Description | | --- | --- | | --live | Show only matches currently in play | | --date <YYYY-MM-DD> | Fetch fixtures for a specific day | | --json | Print the raw calendar response as JSON | | --help | Show usage |

Library

import {
  fetchCalendar,
  filterMatches,
  groupByTournament,
  formatLine,
  formatScore,
  isLive,
} from 'futbol-libre-hoy';

// Fetch live matches
const cal = await fetchCalendar({ filter: 'live' });
for (const m of cal.matches) {
  console.log(formatLine(m), m.url);
}

// Group a day's fixtures by competition
const day = await fetchCalendar({ date: '2026-08-09' });
const byComp = groupByTournament(day.matches);

API

| Export | Signature | Description | | --- | --- | --- | | fetchCalendar | (opts?) => Promise<CalendarResponse> | Fetch fixtures. Options: { date?, filter?, baseUrl? } | | filterMatches | (matches, filter) => Match[] | Filter by live, upcoming, or finished | | groupByTournament | (matches) => Group[] | Group matches by competition, in feed order | | formatLine | (match) => string | One-line Home 1 - 0 Away summary | | formatScore | (match) => string | Just the score, or kickoff time if not started | | isLive | (match) => boolean | Whether a match is in play |

Data source

Reads the public calendar feed at https://verfutbollibre.net/api/v1/calendar. No API key required. See DISCLAIMER.md.

Source & docs

Repository: https://github.com/nazzal12/ver-fubtol-libre-pckgs

License

MIT © NBK Devs