.codex-plugin/plugin.json

{
  "name": "golden-hour",
  "version": "1.0.0",
  "description": "Local sun times and photography light windows.",
  "author": {
    "name": "Zovo",
    "email": "support@zovo.one",
    "url": "https://zovo.one"
  },
  "homepage": "https://golden-hour.zovo.one",
  "license": "Proprietary",
  "keywords": [
    "golden hour calculator",
    "golden hour time",
    "sunrise sunset times",
    "sunset time today",
    "what time is golden hour",
    "blue hour",
    "sunrise time",
    "photography golden hour",
    "day length",
    "twilight times"
  ],
  "skills": "./skills/",
  "mcpServers": "./.mcp.json",
  "interface": {
    "displayName": "Sunvane Golden Hour",
    "shortDescription": "Sun times & shoot planning",
    "longDescription": "Plan photography with golden hour time, sunrise sunset times, blue hour and twilight times for a city and local date. Sunvane Golden Hour calculates morning and evening light windows, solar noon, day length, and sunrise and sunset direction. Use the interactive card to change a city or date.\n\nPlan photography golden hour shoots for 1 to 31 days, then download an ICS calendar with one event per light window and a CSV table. Compare day length between two dates, or use a year for its equinoxes and solstices. Local times use IANA time zones and daylight saving changes. Missing polar events are reported.\n\nGolden hour means sun altitude \u22124\u00b0 to +6\u00b0; blue hour \u22126\u00b0 to \u22124\u00b0. Sunrise/sunset use \u22120.833\u00b0; civil, nautical and astronomical twilight use \u22126\u00b0, \u221212\u00b0 and \u221218\u00b0. Windows crossing local midnight are clipped and marked.\n\nExamples: golden hour calculator for New York, NY, on 06/21/2026; evening shoots in Los Angeles, CA, starting 10/12/2026 for 7 days.\n\nLimits: a flat horizon at sea level; hills, buildings and weather change the real light. Accuracy is about one minute below 66\u00b0 latitude and uncertainty increases near polar transitions. City coverage is population 50,000+ plus Tromso; dates 1900\u20132100. Day length is daylight within a local civil date. City matches are ranked by population; the first is used and other matches are listed so country or US state can narrow it. Files do not change a calendar. Local clocks follow the host IANA time-zone database; future rules may change.\n\nCity data adapted from GeoNames (https://www.geonames.org/), licensed CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/).",
    "developerName": "Zovo",
    "category": "Productivity",
    "capabilities": [
      "Interactive",
      "Read"
    ],
    "websiteURL": "https://golden-hour.zovo.one",
    "supportURL": "https://golden-hour.zovo.one/support",
    "privacyPolicyURL": "https://golden-hour.zovo.one/privacy",
    "termsOfServiceURL": "https://golden-hour.zovo.one/terms",
    "defaultPrompt": [
      "What time is golden hour in New York, NY, on 06/21/2026?",
      "Plan 7 evening golden hour shoots in Los Angeles, CA, starting 10/12/2026.",
      "Compare day length in Chicago, IL, on 03/20/2026 and 06/21/2026."
    ],
    "brandColor": "#A65B08",
    "brandColorDark": "#F1BC70",
    "composerIcon": "./assets/icon.svg",
    "logo": "./assets/logo.png"
  },
  "extensions": {
    "com.openai": {
      "onboardingSkill": "./skills/golden-hour/SKILL.md",
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Summer sun times",
              "prompt": "What time is golden hour in New York, NY, on 06/21/2026?",
              "tools_triggered": "find_sun_times",
              "expected_behavior": "Reports New York City, NY, US in America/New_York with sunrise 2026-06-21 05:25:01, sunset 2026-06-21 20:30:46, and day length 15h 5m 45s. Shows golden hour, blue hour and twilight with altitude definitions."
            },
            {
              "description": "Shoot calendar",
              "prompt": "Plan 7 evening golden hour shoots in Los Angeles, CA, starting 10/12/2026.",
              "tools_triggered": "plan_golden_hour_shoot",
              "expected_behavior": "Returns 7 golden hour calendar events with local windows, ICS and CSV downloads."
            },
            {
              "description": "Daylight change",
              "prompt": "Compare day length in Chicago, IL, on 03/20/2026 and 06/21/2026.",
              "tools_triggered": "compare_day_length",
              "expected_behavior": "Returns daylight difference 11062 seconds and average 118.95 seconds/day."
            },
            {
              "description": "Polar night",
              "prompt": "Find sunrise sunset times and blue hour in Tromso, Norway, on 12/21/2026.",
              "tools_triggered": "find_sun_times",
              "expected_behavior": "Reports sunrise and sunset do not occur on this date, day length 0h 0m 0s, and available twilight and light windows."
            },
            {
              "description": "Seasonal comparison",
              "prompt": "Compare day length at the equinoxes and solstices of 2026 in New York, NY.",
              "tools_triggered": "compare_day_length",
              "expected_behavior": "Computes local seasonal dates and daylight durations, with signed differences and average changes per day."
            }
          ],
          "negative": [
            {
              "description": "General photography technique does not require a solar calculation.",
              "prompt": "How do I take better portraits with a reflector?"
            },
            {
              "description": "Weather forecasts are outside the solar calculation scope.",
              "prompt": "Will it rain during my photo shoot in Boston tomorrow?"
            },
            {
              "description": "Photo editing does not require solar times.",
              "prompt": "Make this photo look like it was taken at golden hour."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "This plugin does not sell products or process payments.",
        "demo_recording_url": "https://golden-hour.zovo.one/dl/demo/q64FAA"
      },
      "publication": {
        "countries": [],
        "release_notes": "Initial release: local solar times, light windows, shoot calendar and CSV downloads, daylight comparisons.",
        "translations": {
          "pl-PL": {
            "subtitle": "S\u0142o\u0144ce i planowanie zdj\u0119\u0107",
            "description": "Oblicz wsch\u00f3d i zach\u00f3d s\u0142o\u0144ca, z\u0142ot\u0105 i niebiesk\u0105 godzin\u0119 oraz zmierzch dla miasta i daty. Zaplanuj zdj\u0119cia na okres do 31 dni z plikami ICS i CSV. Por\u00f3wnaj d\u0142ugo\u015b\u0107 dnia. Czasy lokalne uwzgl\u0119dniaj\u0105 zmian\u0119 czasu. P\u0142aski horyzont na poziomie morza; teren i pogoda wp\u0142ywaj\u0105 na \u015bwiat\u0142o. Miasta od 50 000 mieszka\u0144c\u00f3w, lata 1900\u20132100. Dane miast: GeoNames, CC BY 4.0."
          },
          "de-DE": {
            "subtitle": "Sonnenzeiten & Fotoplanung",
            "description": "Berechne Sonnenaufgang, Sonnenuntergang, goldene und blaue Stunde sowie D\u00e4mmerung f\u00fcr Stadt und Datum. Plane bis zu 31 Tage mit ICS- und CSV-Dateien und vergleiche die Tagesl\u00e4nge. Ortszeiten ber\u00fccksichtigen die Sommerzeit. Flacher Horizont auf Meeresh\u00f6he; Gel\u00e4nde und Wetter beeinflussen das Licht. St\u00e4dte ab 50.000 Einwohnern, Jahre 1900\u20132100. Stadtdaten: GeoNames, CC BY 4.0."
          },
          "es-ES": {
            "subtitle": "Sol y planificaci\u00f3n de fotos",
            "description": "Calcula la salida y puesta del sol, hora dorada, hora azul y crep\u00fasculo para una ciudad y fecha. Planifica hasta 31 d\u00edas con archivos ICS y CSV y compara la duraci\u00f3n del d\u00eda. Horas locales con horario de verano. Horizonte plano al nivel del mar; el terreno y clima afectan la luz. Ciudades de al menos 50.000 habitantes, a\u00f1os 1900\u20132100. Datos: GeoNames, CC BY 4.0."
          },
          "fr-FR": {
            "subtitle": "Soleil et s\u00e9ances photo",
            "description": "Calculez le lever et coucher du soleil, les heures dor\u00e9e et bleue et le cr\u00e9puscule pour une ville et une date. Planifiez jusqu\u2019\u00e0 31 jours avec fichiers ICS et CSV et comparez la dur\u00e9e du jour. Heures locales tenant compte du changement d\u2019heure. Horizon plat au niveau de la mer ; relief et m\u00e9t\u00e9o influencent la lumi\u00e8re. Villes d\u00e8s 50 000 habitants, ann\u00e9es 1900\u20132100. Donn\u00e9es : GeoNames, CC BY 4.0."
          },
          "ja-JP": {
            "subtitle": "\u592a\u967d\u306e\u6642\u523b\u3068\u64ae\u5f71\u8a08\u753b",
            "description": "\u90fd\u5e02\u3068\u65e5\u4ed8\u304b\u3089\u65e5\u306e\u51fa\u30fb\u65e5\u306e\u5165\u308a\u3001\u30b4\u30fc\u30eb\u30c7\u30f3\u30a2\u30ef\u30fc\u3001\u30d6\u30eb\u30fc\u30a2\u30ef\u30fc\u3001\u8584\u660e\u306e\u6642\u523b\u3092\u8a08\u7b97\u3057\u307e\u3059\u3002\u6700\u592731\u65e5\u9593\u306e\u64ae\u5f71\u8a08\u753b\u3092ICS\u3068CSV\u3067\u51fa\u529b\u3057\u3001\u65e5\u7167\u6642\u9593\u3092\u6bd4\u8f03\u3067\u304d\u307e\u3059\u3002\u73fe\u5730\u6642\u523b\u306f\u590f\u6642\u9593\u3092\u8003\u616e\u3057\u307e\u3059\u3002\u6d77\u9762\u9ad8\u5ea6\u306e\u5e73\u3089\u306a\u5730\u5e73\u7dda\u3092\u60f3\u5b9a\u3057\u3001\u5730\u5f62\u3084\u5929\u5019\u306f\u5149\u306b\u5f71\u97ff\u3057\u307e\u3059\u3002\u4eba\u53e35\u4e07\u4eba\u4ee5\u4e0a\u306e\u90fd\u5e02\u30011900\uff5e2100\u5e74\u306b\u5bfe\u5fdc\u3002\u90fd\u5e02\u30c7\u30fc\u30bf\uff1aGeoNames\u3001CC BY 4.0\u3002"
          },
          "pt-BR": {
            "subtitle": "Sol e planejamento de fotos",
            "description": "Calcule nascer e p\u00f4r do sol, hora dourada, hora azul e crep\u00fasculo para uma cidade e data. Planeje at\u00e9 31 dias com arquivos ICS e CSV e compare a dura\u00e7\u00e3o do dia. Hor\u00e1rios locais consideram o hor\u00e1rio de ver\u00e3o. Horizonte plano ao n\u00edvel do mar; relevo e clima afetam a luz. Cidades com pelo menos 50 mil habitantes, anos 1900\u20132100. Dados: GeoNames, CC BY 4.0."
          }
        }
      }
    }
  },
  "apps": "./.app.json"
}