_dedenne, n. A customizable and semantic start page for your browser, built with HTML, CSS, and a sprinkle of JavaScript.

_dedenne's offers users a customizable browser start page featuring organized bookmarks and configurable search options. The monospace font is ol' Fira Code font loaded via Google Fonts. Icons are inline SVGs, DuckDuckGo's API delivers the favicons, and OpenWeather's API provides the weather forecast and icons. Vanilla JavaScript and CSS handle all interactivity.

Public Demo: You can see a live (non-configurable) demo of dedenne here. This version will only load the default configuration.

✨ Features in _dedenne

• Customizable Search Engines: You can now choose between different search engines to use for your searches, including DuckDuckGo, Youtube, Pinterest, and more (full list here).
• Organized Bookmarks: You can now organize your bookmarks into categories with collapsible sections.
• Weather Information: Get real-time weather updates for your location.
• Date & Time Display: View the current date and time in either 12-hour or 24-hour format.
• Light and Dark Modes: Switch between light and dark themes based on your preference or system settings.
• Responsive Design: The layout adapts seamlessly to different screen sizes, ensuring a great user experience on both desktop and mobile devices.

🚀 How to use (Self-Hosting with Docker)

The primary installation method is via Docker Compose. Make sure you have Docker and Docker Compose installed on your machine.

1. Clone or download this repository:

   git clone https://github.com/omartrj/_dedenne.git
   cd _dedenne

2. Create your configuration file:

   # Copy the default configuration as a starting point
   cp configs/default_config.jsonc configs/config.jsonc

3. Edit the configuration file to your liking. See here for details on the available options.
4. Launch with Docker Compose:

   docker compose up -d

5. Open your browser and navigate to http://localhost:8080 to see your new start page!

Alternatively, you can fork this repository and host the page on your own server or GitHub Pages.

⚙️ Configuration overview

The configuration file is a JSON object that allows you to customize the start page to your liking. Here's an overview of the available options:

Logo: you can either use the default dedenne logo using "type": "image", or use the text logo with "type": "text".

Weather: displays the current weather in your location. You will need to generate your own OpenWeather API key and city ID. Available units are metric and imperial.

⚠️ You will need to generate your own OpenWeather API key!

1. Register for an OpenWeather account (OpenWeather will generate a default API key)
2. Sign in and navigate to Username > API keys and copy the key
3. Paste the key into apiKey in the configuration file.

How to update your city

1. Find your city using OpenWeather's search
2. Copy the city ID from the end of the URL

   https://openweathermap.org/city/1850147 🠆 1850147

3. Paste the city ID into cityId in the configuration file.

Date & Time: displays the current date and time. You can choose between 12-hour and 24-hour formats.

Search Providers: At the moment DuckDuckGo, Google, YouTube, Reddit, Wikipedia, Pinterest, Stack Overflow are the supported search engines. The first provider in the list will be the default search engine.

"searchProviders": ["google", "duckduckgo", "youtube", "reddit", "wikipedia", "pinterest", "stackoverflow"]

Bookmark Groups: each group can have a title and a list of bookmarks. Each bookmark should have a name and a url.

🖼️ Previews