Skip to content

luscis/cecilia

Repository files navigation

Cecilia

A modern Electron application for managing HTTP, DNS, and SOCKS5 proxy instances with a beautiful dark-themed UI.

Electron Vue Vite

Features

  • 🌐 Multi-Protocol Support - HTTP, DNS, and SOCKS5 proxy support
  • 🚀 Multi-Instance Management - Run and manage multiple proxy instances simultaneously
  • 📊 Real-time Status Monitoring - Track instance status with color-coded indicators
  • 📝 Live Log Viewer - View instance logs in real-time with auto-scroll
  • ⚙️ Flexible Configuration - Import/export proxy configurations easily
  • 🎨 Dark Theme UI - Easy on the eyes with a modern dark interface
  • Hot Module Replacement - Fast development with HMR support
  • 🖥️ Cross-Platform - Built for Windows, macOS, and Linux

Tech Stack

  • Framework: Electron 35.1.5
  • Frontend: Vue 3.5.13 + Vite 6.2.6
  • UI Library: Element3
  • Build Tool: electron-vite + electron-builder

Project Setup

Install Dependencies

npm install

Development

Start the development server with hot reload:

npm run dev

Build for Production

# Build for current platform
npm run build

# Build for Windows
npm run build:win

# Build for macOS
npm run build:mac

# Build for Linux
npm run build:linux

# Build without packaging (unpack)
npm run build:unpack

Scripts

Command Description
npm run dev Start development server
npm run build Build for production
npm run build:win Build for Windows
npm run build:mac Build for macOS
npm run build:linux Build for Linux
npm run format Format code with Prettier
npm run lint Lint code with ESLint

Project Structure

cecilia/
├── src/
│   ├── main/           # Electron main process
│   ├── preload/        # Preload scripts
│   └── renderer/       # Vue renderer process
│       └── src/
│           ├── components/
│           │   ├── CeciManager.vue    # Main manager component
│           │   └── InstanceCard.vue   # Instance card component
│           ├── App.vue
│           └── main.js
├── resources/          # App resources (icon, configs)
├── build/              # Build configuration
└── package.json

Recommended IDE Setup

License

MIT

About

Client Application for OpenCeci, and Writed by Qwen Code.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors