Skip to content

Memory Cat v0.3.2

Choose a tag to compare

View all tags
@hyeonheebee hyeonheebee released this 11 Sep 02:10
· 17 commits to main since this release
v0.3.2
c6166a6
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

A desktop cat for macOS and Windows that gets chonkier as your memory fills up.

Fixed in 0.3.2 — 0.3.1 read your memory correctly, but the cat barely moved.
A running Mac never empties its memory, so mapping 0–100% straight onto his shapes meant you only ever saw two of the six. He now changes shape at the same points his name changes: He chomnk at 60%, A heckin' chonker at 70%, HEFTYCHONK at 80%, MEGACHONKER at 90%, OH LAWD HE COMIN at 96%. The picture and the name can no longer disagree.

Also fixed: picking whichever is fuller could make him fatter than either memory or storage alone; and the diagnosis reported a memory score about a third too low on the rare Macs where macOS refuses to report swap.

The cat still follows your memory by default — close a few apps and watch him slim down within seconds. Right-click → What makes him chonky to switch to storage, or to whichever is fuller.

한국어 안내는 아래에 있습니다.

Download for macOS — from source

git clone https://github.com/hyeonheebee/memory-cat.git
cd memory-cat
./install_mac.command

The installer builds the app and sets it to start at login. Remove it with ./uninstall_mac.command. This path works on Intel Macs too, and does not trip the warning below.

Download for macOS — the zip

If you would rather not use a terminal. There is now a build for Intel Macs too.

Your Mac File Needs
Apple Silicon Memory-Cat-macOS-AppleSilicon.zip macOS 11 or later
Intel Memory-Cat-macOS-Intel.zip macOS 10.13 or later
  1. Download the file for your Mac below and unzip it.
  2. Drag Memory Cat.app into your Applications folder.
  3. Open it once — see below, because the steps changed in macOS 15.

Why macOS refuses the first time

The app is not code-signed, so double-clicking makes macOS say "Apple could not verify 'Memory Cat' is free of malware." That is Apple's rule about signatures, not an error.

On macOS 15 (Sequoia) and later, the dialog only offers Done and Move to Trash — right-clicking no longer helps. Press Done, then open System Settings → Privacy & Security, scroll to the bottom, and press Open Anyway next to "Memory Cat" was blocked. That row only appears right after a blocked launch.

On macOS 11–14, right-click the app → Open, then click Open again.

Either way you only do this once. After that it opens normally.

To start it at login, run it once, then enable it in System Settings → General → Login Items & Extensions.

Windows

Download MemoryCat.exe below and run it. Nothing to install.

From this release the .exe is built by GitHub Actions from this repository, so the build log is public and the checksum below comes from that run.

Windows will warn you

The executable is not signed either, so SmartScreen shows "Windows protected your PC." Click More info → Run anyway. Some antivirus software flags PyInstaller executables as a false positive; if yours does, you can build it yourself from the windows/ folder.

The Windows build has the cat, disk / RAM / swap readouts, top memory consumers, four themes, four sizes, and a Korean / English toggle. The AI features — diagnosis, pet themes, cleanup — are macOS only. In exchange it has no OpenAI dependency and makes no network requests at all.

Turning on cleanup and custom pet themes — optional, needs an OpenAI API key

Memory Cat works without a key. (It still watches your disk and memory.)

Put an OPENAI_API_KEY in ~/Library/Application Support/Memory Cat/.env and the 🐾 What did you eat? diagnosis can clear disk space (Trash, caches, old downloads), and you can build a theme from a photo of your own pet.
Only the photo and your usage numbers are sent — file names and paths are never sent.

Checksums

SHA-256  7c12627b8facb260cb7e87a5caf9a73b526600737b81dc3e7706bcec76774e67
Memory-Cat-macOS-AppleSilicon.zip

SHA-256  441f4eb58de4427ab3db164635d4f30a994608030685fece3a866e2a0d2060cc
Memory-Cat-macOS-Intel.zip

SHA-256  916b94dcaae015a19c88da3c18578fa85a89b1c8f0b0fb44543fceac6830c503
MemoryCat.exe

MIT License — for the code. The name "Memory Cat" / "메모리 뚱냥이" and the cat artwork are not part of that grant; please use a different name if you redistribute a modified version.

The Windows build bundles PySide6 (LGPL). Its source and build script are in windows/, and the executable here is built from them by GitHub Actions.

Found a problem? Please open an issue.

한국어

메모리가 찰수록 뚱뚱해지는 macOS 바탕화면 고양이입니다.

0.3.2 에서 고친 것 — 0.3.1 은 메모리를 제대로 쟀는데 고양이가 거의 안 움직였습니다.
켜져 있는 맥은 메모리를 0 근처까지 비우지 않습니다. 그래서 0~100% 를 고양이 모습에 그대로 옮기니 여섯 가지 중 두 가지밖에 안 보였습니다.
이제 메모리가 60 / 70 / 80 / 90 / 96% 를 지날 때마다 모습이 바뀝니다.

그리고 두 가지 더: 배부른 쪽 을 고르면 메모리·저장공간 어느 쪽보다도 뚱뚱해지던 것, macOS 가 스왑을 알려주지 않는 드문 경우에 진단이 메모리 점수를 3분의 1 쯤 낮게 말하던 것을 고쳤습니다.

기본값은 여전히 메모리입니다. 앱을 몇 개 닫으면 몇 초 안에 홀쭉해지는 게 보입니다. 우클릭 → 무엇으로 뚱뚱해질까 에서 저장공간으로 바꿀 수 있습니다.

터미널을 사용하여 다운로드 받기

git clone https://github.com/hyeonheebee/memory-cat.git
cd memory-cat
./install_mac.command

앱 설치, 로그인 시 자동 실행 등록까지 알아서 합니다. 제거는 ./uninstall_mac.command 로 진행하면 됩니다.

zip으로 다운로드하기

터미널 사용이 어렵다면 이렇게 받으시면 됩니다. 이번부터 Intel Mac용도 있습니다.

내 맥 파일 필요
Apple Silicon Memory-Cat-macOS-AppleSilicon.zip macOS 11 이상
Intel Memory-Cat-macOS-Intel.zip macOS 10.13 이상
  1. 아래에서 내 맥에 맞는 파일을 받아 압축을 풉니다.
  2. Memory Cat.app 을 응용 프로그램 폴더로 드래그합니다.
  3. 처음 한 번은 아래 방법으로 엽니다. macOS 15부터 방법이 바뀌었습니다.

처음에 안 열리는 이유

이 앱은 코드 서명이 되어 있지 않습니다. 그냥 더블클릭하면 macOS에서 "Apple이 악성 소프트웨어가 없는지 확인할 수 없습니다" 라는 경고를 띄웁니다. (버전별 애플의 지침으로 인함이지 보안문제나 에러는 아닙니다)

macOS 15 (Sequoia) 이상에서는 그 창에 완료 와 휴지통으로 이동 만 있고 여는 버튼이 없습니다. 우클릭도 통하지 않습니다. 완료를 누른 뒤 시스템 설정 → 개인정보 보호 및 보안에서 맨 아래로 내려가면 "Memory Cat"이(가) 차단되었습니다 옆에 그래도 열기 버튼이 있습니다. 이 항목은 차단 직후에만 보이니, 앱을 먼저 한 번 눌러 주세요.

macOS 11~14에서는 앱을 우클릭 → "열기" 를 선택하고, 다시 한 번 "열기" 를 누르시면 됩니다.

어느 쪽이든 처음 한 번만 하면 됩니다. 그 뒤로는 더블클릭으로 열립니다.

맥 재시동 후 로그인할 때 자동으로 뜨게 하려면 앱을 한 번 실행한 뒤
시스템 설정 → 일반 → 로그인 항목 및 확장 프로그램에서 켜 주세요.

디스크 정리 기능 및 커스텀 테마 만들기 기능 활성화 하기 — OpenAI API 키 추가 시 / 선택(확장) 기능

API 키 없이도 Memory Cat은 정상 동작합니다. (메모리 감시 가능)

만약 OPENAI_API_KEY 를 ~/Library/Application Support/Memory Cat/.env 에 넣으면
"🐾 뭘 먹은 거야?" 진단으로 디스크 (휴지통·캐시·다운로드)를 정리하는 기능과 내 반려동물 사진으로 테마 만들기 기능을 추가로 사용할 수 있습니다.
사진과 사용량 수치만 전송되고, 파일 이름이나 경로는 보내지 않습니다.

Windows

아래 MemoryCat.exe 를 받아서 실행하시면 됩니다. 따로 설치할 것은 없습니다.

이번 릴리스부터 exe는 이 저장소에서 GitHub Actions로 빌드합니다. 빌드 로그가 공개되어 있고, 아래 체크섬은 그 빌드에서 나온 값입니다.

실행할 때 경고가 뜹니다

exe도 코드 서명이 없어서 SmartScreen이 "Windows의 PC를 보호했습니다" 를 띄웁니다. 추가 정보 → 실행을 누르시면 됩니다. 백신이 PyInstaller로 만든 exe를 오탐으로 막는 경우도 있는데, 그럴 때는 windows/ 폴더의 안내를 따라 직접 빌드하실 수 있습니다.

Windows판에는 고양이, 디스크·램·스왑 표시, 메모리 많이 쓰는 앱 목록, 테마 4종, 크기 4종, 한국어/English 전환이 있습니다. AI 기능(진단·펫 테마·정리)은 macOS 전용입니다. 대신 OpenAI 의존성이 없고 네트워크 요청을 전혀 하지 않습니다.

검증용 체크섬

SHA-256  7c12627b8facb260cb7e87a5caf9a73b526600737b81dc3e7706bcec76774e67
Memory-Cat-macOS-AppleSilicon.zip

SHA-256  441f4eb58de4427ab3db164635d4f30a994608030685fece3a866e2a0d2060cc
Memory-Cat-macOS-Intel.zip

SHA-256  916b94dcaae015a19c88da3c18578fa85a89b1c8f0b0fb44543fceac6830c503
MemoryCat.exe

MIT License — 코드에 대한 것입니다. "Memory Cat" / "메모리 뚱냥이" 라는 이름과 고양이 그림은 포함되지 않습니다. 수정본을 배포하실 때는 다른 이름을 써 주세요.

윈도우 빌드에는 PySide6(LGPL)가 들어 있습니다. 소스와 빌드 스크립트가 windows/ 에 있고, 여기 올라온 exe 는 그것으로 GitHub Actions 에서 빌드한 것입니다.

문제가 있으면 Issues에 남겨 주세요.

Assets 5
Loading