https://github.com/creeper82/upcoming-holidays

A simple console app that queries and displays the upcoming holidays for your country. Powered by https://www.openholidaysapi.org/
https://github.com/creeper82/upcoming-holidays

api c-sharp calendar cli desktop dotnet holidays holidays-calendar https

Last synced: about 1 month ago
JSON representation

A simple console app that queries and displays the upcoming holidays for your country. Powered by https://www.openholidaysapi.org/

• Host: GitHub
• URL: https://github.com/creeper82/upcoming-holidays
• Owner: creeper82
• License: mit
• Created: 2024-03-04T16:44:07.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2024-10-17T15:07:57.000Z (over 1 year ago)
• Last Synced: 2024-12-30T01:59:44.893Z (over 1 year ago)
• Topics: api, c-sharp, calendar, cli, desktop, dotnet, holidays, holidays-calendar, https
• Language: C#
• Homepage: https://www.openholidaysapi.org/
• Size: 374 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Upcoming Holidays

A simple C# console app that queries and displays the upcoming holidays for your country. Powered by https://www.openholidaysapi.org/

## Features

- Friendly command line interface controlled with keyboard

- Fresh data downloaded from the API

- A lot of countries supported

- Names translation

## Installation

To simply install and use the app, go to the [**Releases**](https://github.com/creeper82/Upcoming-holidays/releases) section and install a compressed folder with the newest release. Unpack the zip file

The folder contains .dll libraries and an executable file (**Upcoming-holidays.exe** if you're on Windows). You should run the executable file

There is no automatic installer yet. Just put the app folder into any location, and add a shortcut to the .exe file on your desktop. This way, you will have an easy access to the app.

The app is self-contained, meaning there should theoretically be no need to install anything additionally, but tell me if it doesn't work on your device.

**Please use [Windows Terminal](https://apps.microsoft.com/detail/9N0DX20HK701)** for this app (or just set it as default terminal), if you want a smooth console experience with no visible lags. This applies to pre-Windows 11 users, as Windows Terminal is not installed yet by default

### Linux note

There is a release build for Linux. It should work (permit execution and execute the Upcoming-holidays file), but I prefer to focus on the Windows version

## Screenshots

### Home screen

![Home screen](screenshots/menu.png)

### Holidays

![Holidays](screenshots/holidays.png)

Native language

---

![Holidays translated](screenshots/holidays_translated.png)

Translated to english

## Built with

This app was built using C# with [Microsoft .NET 8.0.4](https://dotnet.microsoft.com/en-us/download)

## Documentation

You can find app usage instructions in the help menu. The app is rather intuitive to use, just follow the on-screen messages and possible options

This project uses my [SharpViews](https://github.com/creeper82/SharpViews) framework.