Skip to content

ColDog-Studios/ColDog-Locker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

199 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Stable Release Unstable Release Downloads Tests Issues Stargazers License


Logo

ColDog Locker

ColDog Locker is a desktop app for securely locking, unlocking, and managing encrypted file lockers.
Explore the docs »

Report Bug · Request Feature

Table of Contents
  1. About The Project
  2. Getting Started
  3. Usage
  4. Roadmap
  5. Contributing
  6. License
  7. Contact
  8. Acknowledgments

About The Project

ColDog Locker is a desktop app for securely locking, unlocking, and managing encrypted file lockers. It was created by Collin 'ColDog' Laney on 11/17/21 for a security project in Cybersecurity class.

Note

ColDog Locker is still in development. Automated prerelease assets are available from GitHub Releases for validation, but they are not treated as fully supported stable releases yet.

Warning

Windows and macOS packages are unsigned. Windows SmartScreen or macOS Gatekeeper may display a warning because the project does not currently have code-signing certificates.

(back to top)

Built With

  • .Net
  • C#

(back to top)

Getting Started

Prerelease installer assets are published from main on GitHub Releases for Windows, Linux, and macOS. You can also build from source following the instructions below.

Prerequisites

  • .Net .Net 10 SDK
dotnet --version

Building from Source

  1. Clone the repository
git clone https://github.com/ColDog-Studios/ColDog-Locker.git
  1. Navigate to the project directory
cd ColDog-Locker
  1. Restore dependencies
dotnet restore
  1. Build the project
dotnet build
  1. Run the project
dotnet run --project ColDogLocker.Cli

(back to top)

Usage

ColDog Locker is a desktop app for securely locking, unlocking, and managing encrypted file lockers.

Note

dotnet run --project ColDogLocker.Cli and cdlocker can be used interchangeably. On Windows, the compiled executable is cdlocker.exe; on Linux and macOS it is cdlocker.

Interactive Modes

  • GUI (Graphical User Interface): Run cdlocker gui for the Avalonia graphical interface.
  • TUI (Terminal User Interface): Run cdlocker tui for an interactive terminal menu

Command-Line Interface

For scripting, automation, and quick operations, use the CLI commands:

Locker Commands

# Create a new locker
cdlocker new <name> [--path <path>] [--password <pass>]

# Lock a locker (encrypt and hide)
cdlocker lock <name> [--password <pass>]

# Unlock a locker (decrypt and unhide)
cdlocker unlock <name> [--password <pass>]

# List all lockers
cdlocker list [--locked | --unlocked]

# Show locker status
cdlocker status <name>

# Remove a locker
cdlocker remove <name> [--force] [--delete]

Locker Management

# Change locker password
cdlocker change-password <name>

# Verify locker integrity
cdlocker verify <name>

Settings & Database

# View or modify settings
cdlocker settings [set <key> <value>]

# Optimize database
cdlocker db-vacuum

# Show database information
cdlocker db-info

Help & Version

# Display help
cdlocker help [command]

# Show version
cdlocker --version

Quick Examples

# Create a locker with automatic password prompt
cdlocker new MySecrets

# Create a locker at specific path
cdlocker new Docs --path "C:\Sensitive\Documents"

# Lock a locker
cdlocker lock MySecrets

# List only locked lockers
cdlocker list --locked

# Remove locker and delete its contents
cdlocker remove OldLocker --force --delete

# Check locker integrity
cdlocker verify MySecrets

Tip

For detailed command documentation, use cdlocker help <command> or check the /docs folder.

(back to top)

Roadmap

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributing

ColDog Locker is free software under the GNU GPLv3. Public contributions are not broadly accepted yet, but feedback and bug reports are always welcome!

If you encounter a bug or have a suggestion for improvement:

  1. Open an issue with the appropriate tag ("bug" or "enhancement")
  2. Provide detailed information about the issue or suggestion
  3. The ColDog Studios team will review and respond

For business inquiries or collaboration opportunities, please contact us directly.

(back to top)

License

ColDog Locker is free software licensed under the GNU General Public License v3.0. Copyright © 2026 ColDog Studios.

See LICENSE for the full terms and conditions of the GNU GPLv3.

(back to top)

Contact

ColDog Studios - @ColDogStudios - contact@coldogstudios.com

@ColDog5044 Collin-Laney

Collin Laney (ColDog5044) - @ColDog5044 - collin.laney@coldogstudios.com

@ColDog5044 Collin-Laney

(back to top)

Third-Party Libraries

(back to top)

About

ColDog Locker is a desktop app for securely locking, unlocking, and managing encrypted file lockers.

Resources

License

Code of conduct

Security policy

Stars

1 star

Watchers

1 watching

Forks

Contributors