HankunYu

EldenRinging — Communication skill for Claude Code

Communication community

A lightweight macOS notification tool with fullscreen image overlay and audio playback.

How to install EldenRinging

This entry records only its repository, not the path inside it, so there is no exact command to give. Open HankunYu/eldenRinging and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What EldenRinging does

A lightweight macOS notification tool with fullscreen image overlay and audio playback. Supports multiple presets and perfect for Claude Code hooks integration. Built with native Swift.

Alternatives in Communication

Slack — Communication Slack integration via HTTP/OAuth MCP 14k ★
Codepilot — A native desktop GUI for Claude Code — chat, code, and manage projects visually 4.3k ★
Lark Coding Agent Bridge — Bot that bridges Feishu/Lark messenger with a local Claude Code or Codex CLI 2.4k ★

README

Elden Ringing

A simple macOS command-line tool that displays an image overlay and plays audio with support for multiple presets. Perfect for Claude Code hooks or other automation workflows.

![Demo Video](ReadmeAssets/screen-record.gif)

Features

🖼️ Full-screen image overlay with transparent background
🔊 Audio playback
⌨️ Close with any key press or mouse click
🎯 Always-on-top window
🎨 Multiple presets support - Different notifications for different scenarios
⚙️ Simple JSON configuration
🚀 Fast native Swift implementation

Installation

Prerequisites

macOS 12.0 or later
Swift 5.9 or later (comes with Xcode)

Build and Install

# Clone or navigate to the project directory
cd /path/to/eldenRinging

# Run the build script
chmod +x build.sh
./build.sh

This will:

Build the executable
Install it to /usr/local/bin/eldenRinging
Create config directory at ~/.config/eldenRinging/
Copy default config file

Quick Start

After installation, test it immediately:

# Run with default preset
eldenRinging

You should see a full-screen overlay with "Task completed" image and hear the Elden Ring death sound. Press any key to close.

To use with Claude Code, add the hook using `/hooks` command and select "Stop" hook with command `eldenRinging`.

Configuration

Edit the config file at `~/.config/eldenRinging/config.json`:

Default Configuration

{
  "default_preset": "success",
  "presets": {
    "success": {
      "image_path": "Task completed.png",
      "audio_path": "elden-ring-death.mp3",
      "window_opacity": 1.0,
      "image_scaling": "fit"
    }
  }
}

Example with Multiple Presets

{
  "default_preset": "success",
  "presets": {
    "success": {
      "image_path": "Task completed.png",
      "audio_path": "elden-ring-death.mp3",
      "window_opacity": 1.0,
      "image_scaling": "fit"
    },
    "error": {
      "image_path": "error.png",
      "audio_pa