NEXO.TV Documentation

NEXO.TV Documentation

Technical documentation for the NEXO.TV static movie catalog.

Last updated: November 12, 2026

Overview

NEXO.TV is a static web application for browsing and playing a curated movie catalog. The catalog is managed in Google Sheets and enriched with movie metadata from TMDB.

HTMLCSSJavaScriptGoogle SheetsTMDBNetlify

External media and legal scope

NEXO.TV is a public index and interface, not a host for third-party movies. Movies are linked from Internet Archive; in cases involving NEXO.TV original works, audiovisual files may be hosted on external services such as Hugging Face. NEXO.TV only crosses TMDB data with those external URLs.

NEXO.TV does not guarantee the legality, license, authenticity or availability of any external file. The project uses applicable United States copyright rules as an internal cataloging reference, without excluding laws that may apply in other territories or choosing an exclusive jurisdiction. Users must verify the legality of access in their jurisdiction.

Reference to link-service regulations

NEXO.TV's operation as a platform for consulting and locating external content may, where applicable, be subject to the legal framework for intermediary service providers and services that provide links or search tools, including relevant Spanish and European regulations.

Any limitation of liability will depend on compliance with its legal requirements and the specific circumstances of each case.

Rights holders may submit a voluntary removal request or a formal infringement notice by identifying the work, the specific NEXO.TV link, the rights claimed, their contact details and supporting documentation. Notices can be sent to nexotv.info@gmail.com or davidjoseferreiro@gmail.com. NEXO.TV does not claim DMCA section 512 safe-harbor status, a registered DMCA agent or any legal exemption.

NEXO.TV will review requests individually and may disable links or remove catalog entries when appropriate. The absence of a complaint does not establish that a work is legal.

Architecture

ComponentLocationPurpose
Frontendindex.html, styles.css, script.jsCatalog UI, filters, player and local preferences.
CatalogPublished Google SheetEditorial movie data and playback URLs.
TMDB proxynetlify/functions/tmdb.jsFetches metadata without exposing the API token.
Documentationdocs/This technical reference.

movies.json is not used by the application.

Catalog source

The CSV published from Google Sheets is loaded every time the application starts. Requests use a cache-busting parameter and cache: "no-store".

Open the published catalog

Columns

ColumnUse
idCatalogoInternal catalog ID and URL route.
idTMDBTMDB movie ID used for metadata enrichment.
titulo, sinopsis, videoUrlTitle, synopsis and playback source.
año, generosUsed from the sheet when present; TMDB is used when empty.
director, reparto, productorasEditorial fallback values for technical data.
posterURL, landscapeURLFallback artwork when TMDB has no image.
isEssential, isOriginal, hasOscarCatalog filters and labels.

After changing the spreadsheet, use File → Share → Publish to web → Republish.

TMDB integration

The Netlify function calls the TMDB movie endpoint with Spanish localization and credits:

/3/movie/{id}?language=es-ES&append_to_response=credits

It returns:

  • Title, poster and landscape image
  • Rating, release date and runtime
  • Year and genres
  • Director and cast
  • Production companies and countries

Data priority is:

  1. Non-empty values from the Google Sheet.
  2. TMDB values for missing fields.
  3. Video metadata for duration when TMDB has no runtime.

Rating and release date fields are hidden when no value is available.

Reference: TMDB API documentation.

Frontend behavior

  • The loading screen remains visible while the catalog and TMDB data are being loaded.
  • Favorites and Continue Watching use browser localStorage.
  • There is no account or user synchronization system.
  • Essential, Original and Academy Awards filters are controlled by spreadsheet fields.
  • Must See cards and Must See artwork are no longer used.
  • Videos are hosted externally, including Internet Archive and Hugging Face.

Deployment

Netlify hosts the static site and the serverless TMDB function.

Environment variable

Configure this variable in Netlify. Do not put the token in frontend files.

TMDB_READ_TOKEN=YOUR_TMDB_READ_TOKEN

CLI commands

cd "C:\Users\david\OneDrive\Documentos\ReposPersonales\NEXO.TV"
netlify login
netlify link
netlify env:set TMDB_READ_TOKEN "YOUR_TOKEN"
netlify deploy --prod

Local development:

netlify dev

Function test:

/.netlify/functions/tmdb?ids=558

References: Netlify Functions · Netlify dashboard.

Maintenance

Update this documentation whenever a project change affects the data source, metadata, deployment or user interface.

  1. Update the date at the top of this page.
  2. Update the affected section.
  3. Update README.md when setup instructions change.
  4. Run the syntax and diff checks.
  5. Verify that no API token was added to the repository.
node --check .\script.js
node --check .\netlify\functions\tmdb.js
git diff --check