https://github.com/junaslaco/hiveassets
HiveAssets est un outil permettant d’organiser et de centraliser textures, modèles 3D et autres fichiers créatifs. Il est basé sur Python et utilise une interface construite avec ElectronJS.
https://github.com/junaslaco/hiveassets
3d-viewer assets-management audio-player bottlepy electronjs media-preview multimedia python texture-viewer
Last synced: 3 months ago
JSON representation
HiveAssets est un outil permettant d’organiser et de centraliser textures, modèles 3D et autres fichiers créatifs. Il est basé sur Python et utilise une interface construite avec ElectronJS.
- Host: GitHub
- URL: https://github.com/junaslaco/hiveassets
- Owner: JuNaSlaCo
- License: gpl-3.0
- Created: 2025-03-20T21:42:46.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-06-20T11:29:26.000Z (4 months ago)
- Last Synced: 2025-06-20T11:37:06.283Z (4 months ago)
- Topics: 3d-viewer, assets-management, audio-player, bottlepy, electronjs, media-preview, multimedia, python, texture-viewer
- Language: Python
- Homepage:
- Size: 10.5 MB
- Stars: 9
- Watchers: 2
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: license.txt
Awesome Lists containing this project
README
# HiveAssets
HiveAssets est un gestionnaire d'assets (textures, modèles, etc.) permettant d'organiser et de centraliser divers fichiers multimédias.
## Installation et Utilisation
### Versions et Releases
Les versions compilées de HiveAssets sont disponibles dans la section **Releases** du dépôt GitHub. Vous pouvez les télécharger directement et les exécuter sans installation supplémentaire.
Si vous souhaitez modifier le programme ou explorer son fonctionnement, vous pouvez télécharger l'archive du code source directement depuis GitHub.
Le logiciel est toujours en développement, toutes les fonctionnalités ne sont pas encore mises au point.
## Installation pour le Développement
### Prérequis
Avant de commencer, assurez-vous d'avoir installé :
- **Node.js** (version recommandée : LTS)
- **Python 3.10 ou plus**
- **pip** et **virtualenv** (pour l'environnement Python)
### 1. Cloner le Dépôt
```sh
git clone https://github.com/JuNaSlaCo/HiveAssets.git
cd HiveAssets
```
### 2. Installation des Dépendances
#### Côté Serveur Python
Le serveur est basé sur **Bottle** et se trouve dans le dossier `bottle_server`.
```sh
cd bottle_server
python -m venv venv
source venv/bin/activate # Sous Windows : venv\Scripts\activate
pip install -r requirements.txt
```
Le fichier principal est `server.py` :
- Il contient toutes les routes web du serveur ainsi que la logique des scans de fichiers.
- Le fichier `constants.py` regroupe toutes les variables globales.
- Le fichier `config.py` contient toutes les fonctions de configuration du serveur.
Vous pouvez visualiser le serveur en tapant `localhost:5069` dans votre navigateur.
Pour construire le serveur, exécutez :
```sh
build_tools/build_server.bat
```
#### Côté Interface Electron
L'interface utilisateur repose sur **Electron.js**. Pour installer les dépendances :
```sh
npm install
```
Le fichier principal **`main.js`** gère l'initialisation de l'application et la communication avec le serveur Bottle.
Le fichier **`loader.html`** permet d'afficher un écran de chargement en attendant que le serveur soit prêt.
### 3. Lancer l'Application en Mode Développement
#### Démarrer le Serveur Bottle
```sh
cd bottle_server
source venv/bin/activate # Sous Windows : venv\Scripts\activate
python server.py
```
#### Démarrer l'Application Electron
Dans un autre terminal :
```sh
npm start
```
## Compilation & Build
Des scripts de build sont fournis pour compiler l'application selon votre OS :
- **Windows** : `build_electron_win.bat`
- **Linux** : `build_electron_linux.bat` (non testé)
- **Mac** : `build_electron_mac.bat` (non testé)
- **Tous** : `build_electron_all.bat` (non testé)
- **Serveur** : `build_server.bat`
## Commandes npm du projet
- **npm start** : permet de lancer l'application electron
- **npm build** : Permet de construire le projet
- **npm run publish** : Permet de publier le projet sur votre repository GitHub (il faut modifier les informations dans `package.json`)