Repository navigation
PocketBox v0.3.1 — First Public Release 🚀
The first public GitHub release of PocketBox!
PocketBox is a Python-based Windows application that packages files and folders into a single .pbox container and launches the configured application through a dedicated launcher.
✨ Features
- Custom
.pboxformat — Bundle multiple files and folders into one container. - One-click launching — Open
.pboxfiles through the PocketBox launcher. - Original file preservation — Packaging does not modify or delete source files.
- Temporary workspace — Extract packaged files into a separate temporary location for execution.
- Automatic cleanup — Remove temporary files after the launched process finishes.
- File integrity verification — SHA-256 checks and corruption detection.
- Bilingual interface — English and Korean language support.
- Custom icons — Dedicated PocketBox application and
.pboxfile icons.
🛠️ Developer & Repository Improvements
- MIT License.
- Improved GitHub README with English and Korean documentation.
- GitHub Actions workflow.
- Issue and Pull Request templates.
- Contribution guidelines and security policy.
- Project documentation and changelog.
🧪 Testing
- 8 automated tests passed.
- Container creation and extraction tests.
- Corruption detection tests.
- Path traversal validation tests.
- Language settings tests.
⚙️ Build Requirements
- Windows 10 / 11
- Python 3.12 (64-bit)
- Internet connection for the initial dependency installation.
Run build_all.bat to install dependencies and build the PocketBox launcher and builder.
Important
This is an early development release. Windows executable builds and full application execution should be tested on the target Windows environment. Prebuilt executable binaries are not included in this source release.
PocketBox v0.3.1 — 첫 공개 릴리스 🇰🇷
PocketBox의 첫 번째 GitHub 공개 버전입니다!
PocketBox는 여러 파일과 폴더를 하나의 .pbox 컨테이너로 묶고, 전용 런처를 통해 내부에 지정된 프로그램을 실행하는 Python 기반 Windows 프로그램입니다.
✨ 주요 기능
- 자체
.pbox파일 형식 — 여러 파일과 폴더를 하나로 묶습니다. - 원클릭 실행 — PocketBox 런처로
.pbox파일을 실행합니다. - 원본 파일 보존 — 패키징 과정에서 원본 파일을 수정하거나 삭제하지 않습니다.
- 임시 작업 공간 — 별도의 임시 위치에 파일을 추출하여 실행합니다.
- 자동 캐시 정리 — 실행 프로세스가 종료되면 임시 파일을 정리합니다.
- 파일 무결성 검사 — SHA-256 검증 및 파일 손상 감지.
- 한국어 및 영어 지원 — 프로그램 언어 전환 기능.
- 전용 아이콘 — PocketBox 앱 및
.pbox파일 아이콘.
🛠️ 개발 및 저장소 개선
- MIT 오픈소스 라이선스 적용.
- 영어 및 한국어 통합 README.
- GitHub Actions 자동 테스트.
- Issue 및 Pull Request 템플릿.
- 기여 안내 및 보안 정책.
- 프로젝트 문서와 변경 기록 추가.
🧪 테스트
- 자동화 테스트 8개 통과.
- 컨테이너 생성 및 추출 테스트.
- 파일 손상 감지 테스트.
- 경로 조작 방지 테스트.
- 언어 설정 테스트.
⚙️ 빌드 요구 사항
- Windows 10 / 11
- Python 3.12 64비트
- 최초 의존성 설치 시 인터넷 연결 필요.
build_all.bat을 실행하면 필요한 패키지를 설치하고 PocketBox 런처와 Builder를 빌드합니다.
Important
초기 개발 단계의 릴리스입니다. Windows 실행 파일 빌드와 전체 프로그램 실행은 대상 Windows 환경에서 별도로 검증해야 합니다. 이번 소스 릴리스에는 사전 빌드된 EXE가 포함되어 있지 않습니다.
License: MIT