Skip to content

Added more recording options #72

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
devalentineomonya wants to merge 6 commits into
base: main
Choose a base branch
from
Open

Added more recording options #72

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
bc17bc7
My local changes
devalentineomonya Nov 2, 2025
46c589b
Added my screen recorder config
devalentineomonya Dec 14, 2025
79c613e
Updated audio options
devalentineomonya Dec 14, 2025
7f0860e
Fixed window option
devalentineomonya Dec 14, 2025
6ad4fc5
Fixed window option
devalentineomonya Dec 14, 2025
4edc017
Update src/caelestia/subcommands/record.py
devalentineomonya Jan 6, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
211 changes: 170 additions & 41 deletions src/caelestia/parser.py
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,99 +1,224 @@
import argparse

from caelestia.subcommands import clipboard, emoji, record, resizer, scheme, screenshot, shell, toggle, wallpaper
from caelestia.subcommands import (
clipboard,
emoji,
record,
resizer,
scheme,
screenshot,
shell,
toggle,
wallpaper,
)
from caelestia.utils.paths import wallpapers_dir
from caelestia.utils.scheme import get_scheme_names, scheme_variants
from caelestia.utils.wallpaper import get_wallpaper


def parse_args() -> (argparse.ArgumentParser, argparse.Namespace):
parser = argparse.ArgumentParser(prog="caelestia", description="Main control script for the Caelestia dotfiles")
parser.add_argument("-v", "--version", action="store_true", help="print the current version")
parser = argparse.ArgumentParser(
prog="caelestia", description="Main control script for the Caelestia dotfiles"
)
parser.add_argument(
"-v", "--version", action="store_true", help="print the current version"
)

# Add subcommand parsers
command_parser = parser.add_subparsers(
title="subcommands", description="valid subcommands", metavar="COMMAND", help="the subcommand to run"
title="subcommands",
description="valid subcommands",
metavar="COMMAND",
help="the subcommand to run",
)

# Create parser for shell opts
shell_parser = command_parser.add_parser("shell", help="start or message the shell")
shell_parser.set_defaults(cls=shell.Command)
shell_parser.add_argument("message", nargs="*", help="a message to send to the shell")
shell_parser.add_argument("-d", "--daemon", action="store_true", help="start the shell detached")
shell_parser.add_argument("-s", "--show", action="store_true", help="print all shell IPC commands")
shell_parser.add_argument("-l", "--log", action="store_true", help="print the shell log")
shell_parser.add_argument("-k", "--kill", action="store_true", help="kill the shell")
shell_parser.add_argument(
"message", nargs="*", help="a message to send to the shell"
)
shell_parser.add_argument(
"-d", "--daemon", action="store_true", help="start the shell detached"
)
shell_parser.add_argument(
"-s", "--show", action="store_true", help="print all shell IPC commands"
)
shell_parser.add_argument(
"-l", "--log", action="store_true", help="print the shell log"
)
shell_parser.add_argument(
"-k", "--kill", action="store_true", help="kill the shell"
)
shell_parser.add_argument("--log-rules", metavar="RULES", help="log rules to apply")

# Create parser for toggle opts
toggle_parser = command_parser.add_parser("toggle", help="toggle a special workspace")
toggle_parser = command_parser.add_parser(
"toggle", help="toggle a special workspace"
)
toggle_parser.set_defaults(cls=toggle.Command)
toggle_parser.add_argument("workspace", help="the workspace to toggle")

# Create parser for scheme opts
scheme_parser = command_parser.add_parser("scheme", help="manage the colour scheme")
scheme_command_parser = scheme_parser.add_subparsers(title="subcommands")

list_parser = scheme_command_parser.add_parser("list", help="list available schemes")
list_parser = scheme_command_parser.add_parser(
"list", help="list available schemes"
)
list_parser.set_defaults(cls=scheme.List)
list_parser.add_argument("-n", "--names", action="store_true", help="list scheme names")
list_parser.add_argument("-f", "--flavours", action="store_true", help="list scheme flavours")
list_parser.add_argument("-m", "--modes", action="store_true", help="list scheme modes")
list_parser.add_argument("-v", "--variants", action="store_true", help="list scheme variants")
list_parser.add_argument(
"-n", "--names", action="store_true", help="list scheme names"
)
list_parser.add_argument(
"-f", "--flavours", action="store_true", help="list scheme flavours"
)
list_parser.add_argument(
"-m", "--modes", action="store_true", help="list scheme modes"
)
list_parser.add_argument(
"-v", "--variants", action="store_true", help="list scheme variants"
)

get_parser = scheme_command_parser.add_parser("get", help="get scheme properties")
get_parser.set_defaults(cls=scheme.Get)
get_parser.add_argument("-n", "--name", action="store_true", help="print the current scheme name")
get_parser.add_argument("-f", "--flavour", action="store_true", help="print the current scheme flavour")
get_parser.add_argument("-m", "--mode", action="store_true", help="print the current scheme mode")
get_parser.add_argument("-v", "--variant", action="store_true", help="print the current scheme variant")
get_parser.add_argument(
"-n", "--name", action="store_true", help="print the current scheme name"
)
get_parser.add_argument(
"-f", "--flavour", action="store_true", help="print the current scheme flavour"
)
get_parser.add_argument(
"-m", "--mode", action="store_true", help="print the current scheme mode"
)
get_parser.add_argument(
"-v", "--variant", action="store_true", help="print the current scheme variant"
)

set_parser = scheme_command_parser.add_parser("set", help="set the current scheme")
set_parser.set_defaults(cls=scheme.Set)
set_parser.add_argument("--notify", action="store_true", help="send a notification on error")
set_parser.add_argument("-r", "--random", action="store_true", help="switch to a random scheme")
set_parser.add_argument("-n", "--name", choices=get_scheme_names(), help="the name of the scheme to switch to")
set_parser.add_argument(
"--notify", action="store_true", help="send a notification on error"
)
set_parser.add_argument(
"-r", "--random", action="store_true", help="switch to a random scheme"
)
set_parser.add_argument(
"-n",
"--name",
choices=get_scheme_names(),
help="the name of the scheme to switch to",
)
set_parser.add_argument("-f", "--flavour", help="the flavour to switch to")
set_parser.add_argument("-m", "--mode", choices=["dark", "light"], help="the mode to switch to")
set_parser.add_argument("-v", "--variant", choices=scheme_variants, help="the variant to switch to")
set_parser.add_argument(
"-m", "--mode", choices=["dark", "light"], help="the mode to switch to"
)
set_parser.add_argument(
"-v", "--variant", choices=scheme_variants, help="the variant to switch to"
)

# Create parser for screenshot opts
screenshot_parser = command_parser.add_parser("screenshot", help="take a screenshot")
screenshot_parser = command_parser.add_parser(
"screenshot", help="take a screenshot"
)
screenshot_parser.set_defaults(cls=screenshot.Command)
screenshot_parser.add_argument("-r", "--region", nargs="?", const="slurp", help="take a screenshot of a region")
screenshot_parser.add_argument(
"-f", "--freeze", action="store_true", help="freeze the screen while selecting a region"
"-r", "--region", nargs="?", const="slurp", help="take a screenshot of a region"
)
screenshot_parser.add_argument(
"-f",
"--freeze",
action="store_true",
help="freeze the screen while selecting a region",
)

# Create parser for record opts
record_parser = command_parser.add_parser("record", help="start a screen recording")
record_parser.set_defaults(cls=record.Command)
record_parser.add_argument("-r", "--region", nargs="?", const="slurp", help="record a region")
record_parser.add_argument("-s", "--sound", action="store_true", help="record audio")
record_parser.add_argument("-p", "--pause", action="store_true", help="pause/resume the recording")

# Recording mode options - separate video and audio modes
record_parser.add_argument(
"-m",
"--mode",
choices=["fullscreen", "region", "window"],
default="fullscreen",
help="video recording mode (default: fullscreen)",
)

record_parser.add_argument(
"-a",
"--audio",
choices=["none", "mic", "system", "combined"],
default="none",
help="Audio recording mode",
)

# Region option (only used with region mode)
record_parser.add_argument(
"-r",
"--region",
nargs="?",
const="slurp",
help="record a region (only for region mode)",
)

# Control options
record_parser.add_argument(
"-p", "--pause", action="store_true", help="pause/resume the recording"
)
record_parser.add_argument(
"-s", "--stop", action="store_true", help="stop the current recording"
)
record_parser.add_argument(
"--status", action="store_true", help="check recording status"
)

# Create parser for clipboard opts
clipboard_parser = command_parser.add_parser("clipboard", help="open clipboard history")
clipboard_parser = command_parser.add_parser(
"clipboard", help="open clipboard history"
)
clipboard_parser.set_defaults(cls=clipboard.Command)
clipboard_parser.add_argument("-d", "--delete", action="store_true", help="delete from clipboard history")
clipboard_parser.add_argument(
"-d", "--delete", action="store_true", help="delete from clipboard history"
)

# Create parser for emoji-picker opts
emoji_parser = command_parser.add_parser("emoji", help="emoji/glyph utilities")
emoji_parser.set_defaults(cls=emoji.Command)
emoji_parser.add_argument("-p", "--picker", action="store_true", help="open the emoji/glyph picker")
emoji_parser.add_argument("-f", "--fetch", action="store_true", help="fetch emoji/glyph data from remote")
emoji_parser.add_argument(
"-p", "--picker", action="store_true", help="open the emoji/glyph picker"
)
emoji_parser.add_argument(
"-f", "--fetch", action="store_true", help="fetch emoji/glyph data from remote"
)

# Create parser for wallpaper opts
wallpaper_parser = command_parser.add_parser("wallpaper", help="manage the wallpaper")
wallpaper_parser = command_parser.add_parser(
"wallpaper", help="manage the wallpaper"
)
wallpaper_parser.set_defaults(cls=wallpaper.Command)
wallpaper_parser.add_argument(
"-p", "--print", nargs="?", const=get_wallpaper(), metavar="PATH", help="print the scheme for a wallpaper"
"-p",
"--print",
nargs="?",
const=get_wallpaper(),
metavar="PATH",
help="print the scheme for a wallpaper",
)
wallpaper_parser.add_argument(
"-r",
"--random",
nargs="?",
const=wallpapers_dir,
metavar="DIR",
help="switch to a random wallpaper",
)
wallpaper_parser.add_argument(
"-r", "--random", nargs="?", const=wallpapers_dir, metavar="DIR", help="switch to a random wallpaper"
"-f", "--file", help="the path to the wallpaper to switch to"
)
wallpaper_parser.add_argument(
"-n", "--no-filter", action="store_true", help="do not filter by size"
)
wallpaper_parser.add_argument("-f", "--file", help="the path to the wallpaper to switch to")
wallpaper_parser.add_argument("-n", "--no-filter", action="store_true", help="do not filter by size")
wallpaper_parser.add_argument(
"-t",
"--threshold",
Expand All @@ -110,7 +235,9 @@ def parse_args() -> (argparse.ArgumentParser, argparse.Namespace):
# Create parser for resizer opts
resizer_parser = command_parser.add_parser("resizer", help="window resizer daemon")
resizer_parser.set_defaults(cls=resizer.Command)
resizer_parser.add_argument("-d", "--daemon", action="store_true", help="start the resizer daemon")
resizer_parser.add_argument(
"-d", "--daemon", action="store_true", help="start the resizer daemon"
)
resizer_parser.add_argument(
"pattern",
nargs="?",
Expand All @@ -125,6 +252,8 @@ def parse_args() -> (argparse.ArgumentParser, argparse.Namespace):
)
resizer_parser.add_argument("width", nargs="?", help="width to resize to")
resizer_parser.add_argument("height", nargs="?", help="height to resize to")
resizer_parser.add_argument("actions", nargs="?", help="comma-separated actions to apply (float,center,pip)")
resizer_parser.add_argument(
"actions", nargs="?", help="comma-separated actions to apply (float,center,pip)"
)

return parser, parser.parse_args()
Loading