This prototype keeps event data in data/events.yaml, with source definitions in data/sources.yaml.

The importer in scripts/import_events.py can normalize:

  • iCal/ICS calendars from venues and public calendars.
  • CSV exports from spreadsheets, box office tools, or community submission forms.
  • JSON feeds from council, venue, ticketing, or tourism systems.

Approved first-pass live-feed targets:

  • Eastgate Theatre, MacArts, Traquair House, Live Borders What’s On, and the Great Tapestry of Scotland.
  • Abbotsford, Alchemy Film & Arts, Borders Book Festival, and VisitScotland regional event listings.
  • Music sources from Eventbrite, Borders Chamber Choir, and Borders Chamber Orchestra.
  • Food-market sources from Kelso Farmers Market, The Wigtown Market, and Langholm Producers Market.
  • St Boswells Village Hall, St Boswells Fair, Coldstream Civic Week, The Hirsel, and Duns Castle / Duns Castle Nature Reserve.
  • Borders Events Centre and Trimontium Museum event listings.

Each imported event should preserve its original source link so visitors can confirm details with the organiser.

Photo assets are listed in data/photos.yaml so they can be swapped for local commissioned images, council media, venue photography, or other licensed sources without changing templates.

html

Eastgate Theatre

approved
Town
Peebles
Area
tweeddale
Priority
1

Parse dated What’s On listings and preserve original ticket links.

artstheatrefilmfamily
Open source

html

MacArts

approved
Town
Galashiels
Area
eildon
Priority
1

Parse homepage and event listing cards, with TicketSource links as canonical URLs.

musicartscommunity
Open source

html

Traquair House

approved
Town
Innerleithen
Area
tweeddale
Priority
1

Import seasonal house, grounds, market, and family listings.

heritagefamilyoutdoors
Open source

html

Live Borders What’s On

approved
Area
all
Priority
1

Parse live events across Heart of Hawick, town halls, museums, galleries, libraries, and sports venues.

artssportlearningfamily
Open source

html

Great Tapestry of Scotland

approved
Town
Galashiels
Area
eildon
Priority
1

Import exhibition, workshop, talk, and family activity listings.

heritageartslearningfamily
Open source

seasonal-html

Borders Book Festival

approved
Town
Melrose
Area
eildon
Priority
1

Keep the festival dates as a notable event now, then import the programme when released.

booksartslearningfamilymusic
Open source

ics

Borders Chamber Choir

approved
Town
Melrose
Area
eildon
Priority
1

The upcoming concerts page exposes Google Calendar and ICS links per concert.

musicclassicalchoir
Open source

rss

Borders Chamber Orchestra

approved
Town
Melrose
Area
eildon
Priority
1

Prefer the published events RSS feed, with the event list page as a human review fallback.

musicclassicalorchestra
Open source

facebook

Kelso Farmers Market

approved
Town
Kelso
Area
cheviot
Priority
1

Facebook public metadata says the market is held on the 4th Saturday of every month. July 2026 is a locked exception moved from 25 July to 11 July and must not be reverted by imports.

foodmarketlocal-producefamily
Open source

annual-reference

St Boswells Fair

approved
Town
St Boswells
Area
eildon
Priority
1

Annual fair day is listed as 18 July each year. Keep as a notable recurring event and replace the reference link if a primary organiser page is found.

fairheritagecommunityfamily
Open source

annual-reference

Coldstream Civic Week

approved
Town
Coldstream
Area
berwickshire
Priority
1

Listed as running during the first week of August. Import the full programme when an official Civic Week page or poster is available.

civic-weekheritagecommunityoutdoors
Open source

ics

Borders Events Centre

approved
Town
Kelso
Area
cheviot
Priority
1

Use the published iCalendar export for public events at Springwood Park, Kelso, including shows, fairs, rallies, sales, and seasonal events.

exhibitionsfairsmarketsmusicfamily
Open source

html

Trimontium Museum

approved
Town
Melrose
Area
eildon
Priority
1

Parse the events page for dated museum events, talks, walks, workshops, exhibits, and the Roman & Iron Age Festival; preserve individual event links and booking links where present.

heritagelearningtalkswalksfamily
Open source

html

Abbotsford

approved
Town
Melrose
Area
eildon
Priority
2

Separate true events from news posts and retain Abbotsford booking links.

heritageartslearningfamily
Open source

html

Alchemy Film & Arts

approved
Town
Hawick
Area
teviot-liddesdale
Priority
2

Import festival schedule items when the annual programme is published.

filmartslearning
Open source

aggregator

Eventbrite Scottish Borders Music

approved
Area
all
Priority
2

Import public music listings cautiously and de-duplicate against venue-owned sources.

musicnightlifecommunity
Open source

facebook

The Wigtown Market

approved
Town
Wigtown
Area
dumfries-galloway
Priority
2

Facebook public metadata says it runs every Saturday, 10am-3pm, April to October.

foodmarketlocal-producecommunity
Open source

facebook

Langholm Producers Market

approved
Town
Langholm
Area
dumfries-galloway
Priority
2

Facebook public metadata identifies this as a food and produce market. The next market date, 1 August 2026, was confirmed from Facebook image content and is locked against text-only imports.

foodmarketlocal-producecommunity
Open source

community-html

St Boswells Village Hall

approved
Town
St Boswells
Area
eildon
Priority
2

Use as a community venue source for St Boswells. Scrape only dated public events and avoid routine/private booking information.

communityartsfamilylearning
Open source

venue-html

The Hirsel

approved
Town
Coldstream
Area
berwickshire
Priority
2

Monitor for public estate, craft, museum, walk, and seasonal listings around Coldstream; avoid importing general visitor-opening information as events.

heritageoutdoorscraftsfamily
Open source

venue-html

Duns Castle and Nature Reserve

approved
Town
Duns
Area
berwickshire
Priority
2

Use for public Duns Castle, estate, and nature-reserve events. Filter out private-hire, wedding, and accommodation content unless public attendance is explicit.

heritageoutdoorsnaturefamily
Open source

aggregator

VisitScotland Events

approved
Area
all
Priority
3

Use as a regional backstop and de-duplicate against primary venue feeds.

tourismartsoutdoorsfamily
Open source