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.
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
| Component | Location | Purpose |
|---|---|---|
| Frontend | index.html, styles.css, script.js | Catalog UI, filters, player and local preferences. |
| Catalog | Published Google Sheet | Editorial movie data and playback URLs. |
| TMDB proxy | netlify/functions/tmdb.js | Fetches metadata without exposing the API token. |
| Documentation | docs/ | 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".
Columns
| Column | Use |
|---|---|
idCatalogo | Internal catalog ID and URL route. |
idTMDB | TMDB movie ID used for metadata enrichment. |
titulo, sinopsis, videoUrl | Title, synopsis and playback source. |
año, generos | Used from the sheet when present; TMDB is used when empty. |
director, reparto, productoras | Editorial fallback values for technical data. |
posterURL, landscapeURL | Fallback artwork when TMDB has no image. |
isEssential, isOriginal, hasOscar | Catalog 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:
- Non-empty values from the Google Sheet.
- TMDB values for missing fields.
- 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.
- Update the date at the top of this page.
- Update the affected section.
- Update
README.mdwhen setup instructions change. - Run the syntax and diff checks.
- Verify that no API token was added to the repository.
node --check .\script.js
node --check .\netlify\functions\tmdb.js
git diff --check