# gdm-settings-dp

**Repository Path**: dddpeter/gdm-settings-dp

## Basic Information

- **Project Name**: gdm-settings-dp
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-27
- **Last Updated**: 2025-10-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p align="center">
  <img src="data/icons/io.github.realmazharhussain.GdmSettings.svg" alt="GDM Settings Icon" width="100" height="100">
</p>

<h1 align="center">GDM Settings</h1>

<div align="center">
  <p><strong>A settings app for GNOME's Login/Display Manager, GDM.</strong></p>
  <p>It is written in Python and uses LibAdwaita for graphical interface.</p>
</div>

<br>

<div align="center">
  <h2>
    <a href="#installation">Install</a>
    <span> | </span>
    <a href="README.zh-CN.md">中文</a>
  </h2>
</div>

## About

GDM Settings is a powerful graphical configuration tool for GNOME's Login/Display Manager (GDM). It provides a user-friendly interface that allows you to easily customize and manage various aspects of GDM without manually editing configuration files.

### Key Features

- 🎨 **Customization** - Set GDM background images, themes, and icons
- 🔐 **Security** - Manage authentication policies and login options
- 🌈 **Visual Enhancement** - Adjust fonts, scaling, and display settings
- ⚙️ **System Integration** - Deep integration with the GNOME desktop environment
- 🌍 **Multilingual Support** - Interface available in multiple languages
- 🚀 **Easy to Use** - Intuitive graphical interface, no manual configuration needed

## Features

### Basic Settings
- Change GDM login background
- Select system theme (light/dark)
- Set default icon theme
- Configure lock screen wallpaper

### Advanced Options
- Enable/disable automatic login
- Configure user avatars and welcome messages
- Manage GDM environment variables
- Adjust font size and scaling

### Visual Effects
- Customize login screen wallpapers
- Choose different GDM themes
- Set screen brightness
- Configure display resolution

## Installation

### Using AppImage

1. Make the AppImage executable:
   ```bash
   chmod +x GDM_Settings.AppImage
   ```
2. Run the application:
   ```bash
   ./GDM_Settings.AppImage
   ```

### Using Flatpak

```bash
# Add the repository
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo

# Install GDM Settings
flatpak install flathub io.github.realmazharhussain.GdmSettings

# Run the application
flatpak run io.github.realmazharhussain.GdmSettings
```

### Build from Source

```bash
# Install dependencies
meson setup build
ninja -C build

# Install (requires root privileges)
sudo ninja -C build install
```

## Requirements

- GNOME Desktop Environment 40 or higher
- Python 3.x
- GDM 40 or higher
- Administrator privileges (required to modify system-level GDM settings)

## Usage

1. Launch the GDM Settings application
2. Select the option you want to configure from the left sidebar
3. Click "Apply" button after making changes
4. Some changes may require re-login or system restart to take effect

## Important Notes

⚠️ **Important**:

- Modifying GDM settings requires administrator privileges
- It is recommended to backup original configurations before applying changes
- Some custom settings may be reset after GDM updates
- If you encounter issues, you can restore defaults via terminal

## Troubleshooting

### Common Issues

**Q: The application won't start?**

A: Ensure all dependencies are installed and check if your system meets the minimum requirements.

**Q: Changes don't take effect?**

A: Try logging out and back in, or restart your system. Some changes require a full GDM service restart.

**Q: How to restore to default settings?**

A: Use the "Reset to defaults" option in the application, or manually edit GDM configuration files via terminal.

## Contributing

Contributions are welcome! You can contribute by:

1. Creating a feature branch (`git checkout -b feature/AmazingFeature`)
2. Committing your changes (`git commit -m 'Add some AmazingFeature'`)
3. Pushing to the branch (`git push origin feature/AmazingFeature`)
4. Opening a Pull Request

## License

This project is licensed under the [GNU General Public License v3.0](LICENSE).

## Acknowledgments

Thanks to all contributors and translators for their support!