Skip to content

Latest commit

 

History

History
257 lines (164 loc) · 13.7 KB

README.md

File metadata and controls

257 lines (164 loc) · 13.7 KB


Material You NewTab

Material You NewTab is a versatile browser extension that personalizes your New Tab page with customizable themes and a welcoming message, all while integrating seamlessly with your preferred search engine.

License Last Commit GitHub contributors GitHub stars GitHub forks

FeaturesCurrently Supported LanguagesInstallation Guide
UsageContributingIssues and SupportPrivacy PolicyLicense

Screenshot 1

✨ Features

  • Customizable Themes: Choose from a selection of themes to match your style.
  • Personalized Greeting: Add a custom message or your name, so you're greeted each time you open a new tab.
  • Integrated Search: Search directly from the New Tab using your preferred search engine—Google, DuckDuckGo, Bing, or YouTube.
  • Browser Compatibility: Supports major browsers like Chrome, Edge, Firefox, Brave, and Safari.

🌐 Currently Supported Languages (18)

Language Code Translator(s)
  English en XengShi, Prem
  Azerbaijani - Azərbaycanca az Hasan Bakhtiar
  Bangla - বাংলা bn It'z RJ, Prem
  Chinese (Simplified) - 中文 zh-CN Guy Berryman, Tianli
  Czech - Čeština cz Michal Šmahel
  French - Français fr 422.io
  Hindi - हिंदी hi XengShi, Prem
  Indonesian - Bahasa Indonesia idn Ayyas-RF
  Italian - Italiano it Claudio Di Maio
  Japanese - 日本語 ja XengShi, S-H-Y-A
  Korean - 한국어 ko XengShi
  Marathi - मराठी mr Prem, Pratik Lokhande
  Portuguese - Português pt-BR Maycon Vitor Correa
  Russian - Русский ru giwi
  Spanish - Español es-ES XengShi
  Turkish - Türkçe tr Nobody
  Uzbek - O'zbek uz Firdavs
  Vietnamese - Tiếng Việt vn Diep

📥 Installation Guide

Download

  1. Clone the Repository:

    git clone https://github.com/XengShi/materialYouNewTab.git
    • Alternatively, download the latest version as a ZIP file by clicking the Download ZIP button below:

    Download ZIP

  2. Direct Download:

    • On the repository page, click the Code button, then select Download ZIP from the dropdown.

Installation

Chromium Chromium-Based Browsers

  1. Install from Chrome Web Store:

    Or follow the manual steps below:

  2. Manual Installation:

    • Prepare the Extension Folder:

      • Ensure you’ve cloned the repository or downloaded the ZIP file and extracted it.
    • Open Extensions Page: Open your preferred browser and enter the following text in the address bar

      • Chrome Chrome: chrome://extensions

      • Edge Edge: edge://extensions

      • Brave Brave: brave://extensions

      • Opera Opera: opera://extensions

    • Enable Developer Mode:

      • Turn on Developer Mode in the extensions page.
    • Load Unpacked Extension:

      • Click on Load unpacked and select your extracted extension folder.

Below are screenshots of the process to guide you through each step visually.

Screenshot 1

Screenshot 2

Screenshot 3


Firefox Firefox

  1. Install from Mozilla Extensions Store:

Screenshot

Or follow the manual steps below:

  1. Manual Installation:

    • Clone the repository or download and extract the ZIP file.

    • Prepare the Manifest:

      • Delete the existing manifest.json file.
      • Rename manifest(firefox).json to manifest.json.
    • Load Temporary Add-on:

      • Go to about:debugging#/runtime/this-firefox, select "This Firefox", then click Load Temporary Add-on.
      • Browse and select the updated manifest.json.

Safari Safari

  1. Clone the repository or download and extract the ZIP file.

  2. Enable Developer Mode:

    • Open Safari, go to Preferences > Advanced and enable Show Develop menu in the menu bar.
  3. Install Extension:

    • Go to Develop > Show Extension Builder, click the "+" button, and select your extension folder.
    • Click Install.

Installation Video

For a step-by-step walkthrough, watch this installation guide video.

Watch the video

📖 Usage

  1. Welcome Greeting:

    • The extension greets you with a personalized message, like "Hello! It’z RJ," and displays the current date. This feature can be customized in the settings to show your name or preferred text, making your browsing experience feel more personal.
  2. Clock Widget:

    • Two clock options are available: a modern analog clock (default) and a digital clock.
    • Users can switch between these clock types in the menu settings, providing flexibility to choose their preferred style for displaying the current time.
  3. Weather Information:

    • Displays real-time weather information for your location, including temperature, weather condition (like "Sunny"), humidity, and "Feels like" temperature.
    • Users can set their location (like "Dhaka") to get accurate weather data. A visual icon represents the weather, and temperature is displayed in degrees Celsius by default. However, it can be switched to Fahrenheit in the menu settings.
  4. Search Bar:

    • The search bar allows you to enter queries directly from the new tab page. This makes it quick and easy to start searching without switching to a different page or window.
    • Below the search bar, there are search engine options that allow you to choose your preferred search engine: Google, DuckDuckGo, Bing, Brave, or YouTube.
    • A voice typing feature is integrated, enabling hands-free searches for added convenience.
  5. Shortcuts:

    • At the bottom, there are quick-access icons for popular platforms, including YouTube, Email, Telegram, WhatsApp, Twitter, and more.
    • Clicking on any of these icons will redirect you to the respective platform, allowing for easy access to your frequently used services.
    • Users can also add their own shortcuts to the menu settings for more personalized quick access.
  6. AI Tools Button:

    • On the bottom left, an "AI Tools" button is available, providing access to AI-powered tools directly from the New Tab page. Tools like ChatGPT, Gemini, Copilot, Perplexity, Adobe Firefly, and Meta AI are integrated for quick, AI-driven assistance or tasks.
  7. Wallpaper Management:

    • Users can upload their own wallpapers via the new wallpaper management section in the menu settings.
    • The Random Image feature provides users with a new wallpaper every day, updating automatically at the start of each day. Images are sourced from Lorem Picsum.
  8. Backup System:

    • The menu settings include a backup system that allows users to save and restore their customized settings.
    • This feature is detailed with screenshots, showing how users can manage backups effectively.
  9. Themes and Personalization:

    • Offers a dynamic theme system inspired by Material You, allowing users to customize colors, backgrounds, and fonts.
    • Personalization options are accessible in the settings, enabling users to tailor the look and feel to their liking.
  10. Google Apps Integration:

    • The extension includes a dedicated section for quick access to Google apps such as Drive, Docs, Sheets, Gmail, and more.
    • This ensures seamless productivity for users who rely on Google services.
  11. Language Selector:

    • A language selector is included in the menu settings, enabling users to choose their preferred language for the extension interface.
    • This feature supports multilingual customization, enhancing accessibility for users worldwide.

🤝 Contributing

Contributions are welcome! If you’d like to contribute:

  1. Follow the guidelines in the CONTRIBUTING.md file.
  2. Fork the repository.
  3. Create a feature branch: git checkout -b feature/YourFeature.
  4. Commit your changes: git commit -m 'Add Your Feature'.
  5. Push to the branch: git push origin feature/YourFeature.
  6. Open a pull request.

❓ Issues and Support

If you encounter any bugs or issues, please submit an issue on the GitHub repository.

🔒 Privacy Policy

For information on how we handle privacy, please read our Privacy Policy.

📜 License

Copyright (C) 2023-2024 XengShi

This project is licensed under the GNU General Public License v3.0 (GPL-3.0). See the LICENSE file for details.

GitHub   Telegram   Email