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