CeLux
CeLux is a high-performance Python library for video processing, leveraging the power of FFmpeg. It delivers some of the fastest decode times for full HD videos globally, enabling efficient and seamless video decoding directly into PyTorch tensors.
The name CeLux is derived from the Latin words celer (speed) and lux (light), reflecting its commitment to speed and efficiency.
Check out the latest changes
📚 Documentation
🚀 Features
- ⚡ Ultra-Fast Video Decoding: Achieve lightning-fast decode times for full HD videos using hardware acceleration.
- 🔗 Direct Decoding to Tensors: Decode video frames directly into PyTorch tensors for immediate processing.
- 🔄 Easy Integration: Seamlessly integrates with existing Python workflows, making it easy to incorporate into your projects.
⚡ Quick Start
pip install celux # cpu only version
from celux import VideoReader, Scale
#import celux as cx
filters = [Scale(width = 1920, height = 1080)]
reader = VideoReader("/path/to/video.ext",
#num_threads: int = os.cpu_count(),
filters = filters,
#tensor_shape: str = 'HWC'
)
for frame in reader:
# do something
📊 Benchmark Summary
| Library | Device | Frames per Second (FPS) |
|---|---|---|
| Celux | CPU | 1520.75 |
| PyAV | CPU | 350.58 |
| OpenCV | CPU | 454.44 |
For more details, see Benchmarks.
📄 License
This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0). See the LICENSE file for details.
🙏 Acknowledgments
- FFmpeg: The backbone of video processing in CeLux.
- PyTorch: For tensor operations and CUDA support.
- Vcpkg: Simplifies cross-platform dependency management.
- @NevermindNilas: For assistance with testing, API suggestions, and more.
1 maintainer
Metadata
1 maintainer
Release files for celux-cuda 0.5.7
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| celux_cuda-0.5.7-py3-none-any.whl | Python 3 | none | any | Details |
Release files / celux_cuda-0.5.7-py3-none-any.whl
| Download URL | celux_cuda-0.5.7-py3-none-any.whl |
|---|---|
| Size | 12.1 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0d30e3aaebe5bf9fc7a60fcffe07791660b9fa1ae6979ac2e36f11924ee6b12b
|
|
BLAKE2b-256 checksum How to use checksums |
b7aa53c054452ec5d2515befaa3e17db34a3815fa264091ee5e348117a816d69
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.9.21
|
