This is a MagicMirror² module for showing upcoming garbage collection dates for Vestfold.

• https://github.com/blixhavn/MMM-AvfallshentingOslo
• https://github.com/reidarw/MMM-TRV-WastePlan

You must have MagicMirror² installed and running first.
MMM-VESAR is a module for MagicMirror and will not work as a standalone application.

In your terminal, go to the modules directory and clone the repository:

cd ~/MagicMirror/modules
git clone https://github.com/ilsegs/MMM-VESAR

Go to the module directory and pull the latest changes:

cd ~/MagicMirror/modules/MMM-VESAR
git pull

MMM-VESAR depends on the following Node.js packages, which are installed automatically when you run npm install in the module directory:

• moment: Used for date formatting and calculations.
• cheerio: Used for parsing HTML returned from the VESAR API.
• node-fetch: Used for making HTTP requests.

Note: You need to have MagicMirror² installed and running before you can use this module.

To use this module, you have to add a configuration object to the modules array in the config/config.js file.

{
  module: "MMM-VESAR",
  position: "top_right",
  config: {
    header: "Neste hentedag for avfall",
    address: "Stasjonsveien 1, Horten",
    useHumanFormat: "by_week",
    dateFormat: "dddd Do MMM",
    showHeader: true,
    displayDate: true,
    displayNumberOfDays: true,
    displayIcons: true,
    displayWasteType: true,
    exclusions: []
  }
}

You can easily customize MMM-VESAR to fit your needs:

• Change address:
  Update the address field in your config to your street and town (e.g. "Stasjonsveien 1, Horten").
  Make sure the format matches exactly as used on vesar.no.

• Show or hide details:
  Use displayDate to show the next pickup date, and displayNumberOfDays to show the number of days until the next pickup ("today", "tomorrow", or "2 dager").
  You can enable both, either, or neither, to control which information is shown.

• Format dates:
  The useHumanFormat option lets you choose between "by_week" (display as day of week, e.g. "Monday") and "strict" (display the raw date).
  Use dateFormat to customize how the date is formatted (e.g. "dddd Do MMM" for "Monday 4th Aug"). See Moment.js format docs for details.

• Icons and waste types:
  Set displayIcons to show or hide waste type icons.
  Set displayWasteType to show or hide the waste type name as text.

• Exclude waste types:
  Add types (e.g., "Restavfall") to the exclusions array if you don't want them displayed.

• Show/hide header:
  Use showHeader to show or hide the header above the table.

• Styling:
  To adjust sizes or colors, edit MMM-VESAR.css in the module folder.

• Translation:
  The module supports Norwegian and English out of the box. Set language: "nb" or language: "en" in your main MagicMirror config.js for your preferred language.

For advanced changes (such as supporting other regions, more languages, or custom waste type translations), you can edit the files in the module folder:

• Change waste type names:
  Edit the wasteTypeTranslations map in MMM-VESAR.js to show custom names for each waste type.

• Add new translations:
  Create translation files in the translations/ folder (e.g., nb.json for Norwegian, en.json for English).

• If nothing is displayed:

  • Check MagicMirror logs (pm2 logs mm).
  • Make sure your config block has no syntax errors.
  • Verify you ran npm install in the MMM-VESAR directory.
  • Open your MagicMirror in a browser and check the developer console for errors.

• If the module is not updating:

  • Ensure your address is valid and covered by VESAR.
  • Try restarting MagicMirror: pm2 restart mm.

• For network access, ensure your MagicMirror config allows remote access:

  address: "0.0.0.0",
  ipWhitelist: [],

See the CHANGELOG.md for version history and updates.

Pull requests are welcome! Please open an issue first to discuss major changes.

• Fork the repo
• Create your feature branch (git checkout -b feature/MyFeature)
• Commit changes (git commit -am 'Add new feature')
• Push to your branch (git push origin feature/MyFeature)
• Open a pull request

This project is licensed under the MIT License - see the LICENSE file for details.