kaubuntu.re/README.md

# Kaubuntu.re - Plateforme Multimédia

Une plateforme multimédia conçue pour diffuser du contenu à partir d'une instance PeerTube.

## Description

Kaubuntu.re est une interface web responsive qui permet de consulter et rechercher des vidéos hébergées sur une instance PeerTube. La plateforme est conçue pour être légère, facilement déployable sur un serveur mutualisé, et optimisée pour les appareils mobiles et desktop.

## Fonctionnalités

- Affichage des vidéos à la une et récentes
- Navigation par catégories
- Lecture de vidéos
- Recherche de contenu
- Interface responsive (mobile et desktop)
- Intégration avec une instance PeerTube

## Technologies utilisées

- HTML5
- CSS3 avec Media Queries pour le responsive design
- PHP pour le backend
- JavaScript pour les interactions côté client
- Bibliothèques externes via CDN:
  - Font Awesome (icônes)
  - jQuery

## Structure du projet

```
├── css/
│   ├── styles.css
│   ├── video-page.css
│   ├── categories.css
│   └── search.css
├── img/
│   ├── categories/
│   ├── video-thumbnails/
│   └── channels/
├── js/
│   └── main.js
├── includes/
│   ├── header.php
│   ├── footer.php
│   ├── mobile-menu.php
│   ├── featured-videos.php
│   ├── recent-videos.php
│   └── categories.php
├── index.php
├── video.php
├── categories.php
├── search.php
└── README.md
```

## Installation

1. Téléchargez ou clonez ce dépôt sur votre ordinateur
2. Importez les fichiers sur votre serveur web compatible PHP (via FTP ou SSH)
3. Assurez-vous que le serveur web peut exécuter des scripts PHP
4. Configurez les paramètres de connexion à votre instance PeerTube (voir configuration)

## Configuration

Pour connecter la plateforme à votre instance PeerTube:

1. Modifiez le fichier `includes/config.php` (à créer) avec les paramètres suivants:
   ```php
   <?php
   // URL de base de votre instance PeerTube
   define('PEERTUBE_URL', 'https://votre-instance-peertube.com');
   
   // Paramètres d'API (si nécessaire)
   define('API_KEY', 'votre-clé-api');
   
   // Autres paramètres de configuration
   define('SITE_NAME', 'Kaubuntu.re');
   define('SITE_DESCRIPTION', 'Votre plateforme de médias libres');
   ?>
   ```

## Personnalisation

Vous pouvez personnaliser l'apparence de la plateforme en modifiant les fichiers CSS dans le dossier `css/`. Pour changer le logo et les couleurs principales:

1. Remplacez le fichier `img/logo.png` par votre propre logo
2. Modifiez les couleurs dans `css/styles.css`

## Déploiement

Pour déployer sur un serveur mutualisé:

1. Assurez-vous que votre hébergeur supporte PHP (version 7.0 minimum recommandée)
2. Transférez tous les fichiers via FTP dans le répertoire racine de votre site
3. Vérifiez que les permissions des fichiers sont correctement définies (644 pour les fichiers, 755 pour les dossiers)
4. Configurez votre domaine pour pointer vers le dossier où vous avez installé l'application

## Développement

Si vous souhaitez contribuer au développement:

1. Créez une branche pour vos modifications: `git checkout -b ma-nouvelle-fonctionnalité`
2. Committez vos changements: `git commit -m 'Ajout d'une nouvelle fonctionnalité'`
3. Poussez vers la branche: `git push origin ma-nouvelle-fonctionnalité`
4. Soumettez une pull request

## Licence

Ce projet est sous licence [MIT](LICENSE).

## Contact

Pour toute question ou suggestion, veuillez nous contacter à [contact@kaubuntu.re](mailto:contact@kaubuntu.re).