PillsNative

Напоминания о лекарствах для Windows, macOS, Linux и Android
Расписание · уведомления · будильник · свои звуки

Русский · English

⬇️ Скачать последнюю версию  ·  🐞 Сообщить о проблеме

---

🇷🇺 Русский

✨ Что это

PillsNative — локальное приложение-напоминалка о приёме лекарств: список приёмов, дата и время, ежедневный режим, отдельное окно будильника со звуком и подтверждением.

	Возможность
💊	Список приёмов с поиском
⏰	Разовые и ежедневные напоминания
🔔	Окно поверх всех приложений, системное уведомление или оба сразу
🔊	Готовые мягкие сигналы и загрузка своей музыки
📝	Подсказки по уже использованным препаратам и дозировкам
🎨	Тёмная / светлая тема в стиле CustomSSH
📥	Трей на десктопе и фон на Android
📱	Сборка для Android (Capacitor) с оверлеем поверх других окон

Текущая версия в репозитории: 3.0.2 (актуальный номер всегда в Releases).

---

⬇️ Скачать и установить

Готовые сборки: GitHub Releases →

🪟 Windows

Файл	Когда брать
PillsNative-Setup-….exe	Обычная установка — рекомендуется, есть автообновление
PillsNative-Portable-….exe	Без установки; обновлять вручную с Releases

1. Скачайте installer или zip.
2. Запустите установщик или распакуйте архив.
3. Откройте PillsNative.

⚠️ Windows может показать SmartScreen. Если доверяете сборке с GitHub: Подробнее → Выполнить в любом случае.

🍎 macOS

Файл	Когда брать
PillsNative-….dmg	Установка через образ
…-darwin-….zip	Архив приложения

1. Скачайте .dmg (или zip) под свою архитектуру.
2. Откройте образ и перетащите приложение в Программы.
3. Запустите PillsNative.

⚠️ Сборка не подписана Apple Developer ID. Сообщение «приложение повреждено» — это Gatekeeper.
ПКМ по приложению → Открыть → снова Открыть,
либо в Terminal:

xattr -cr /Applications/Pills\ Native.app

🐧 Linux

Файл	Когда брать
PillsNative-…-x64.AppImage	Универсальный запуск — рекомендуется, есть автообновление
PillsNative-…-x64.deb	Установка в Debian / Ubuntu

AppImage

chmod +x PillsNative-*-x64.AppImage
./PillsNative-*-x64.AppImage

deb

sudo apt install ./PillsNative-*-x64.deb
# или
sudo dpkg -i PillsNative-*-x64.deb

🤖 Android

Файл	Когда брать
PillsNative-android-….apk	Установка на телефон / эмулятор

1. Скачайте APK с Releases.
2. Разрешите установку из неизвестных источников (если система попросит).
3. Установите и откройте PillsNative.

Debug-сборка из CI не подписана Play Store ключом — для личного использования это нормально.

---

🚀 Быстрый старт

1. Откройте PillsNative.
2. Нажмите Добавить приём.
3. Укажите препарат, дозировку, дату/время (или включите «каждый день»).
4. Сохраните — приложение напомнит в нужный момент.
5. При срабатывании: Выпил таблетку или Отложить 5 мин.

Данные хранятся локально в Документах (pills.json, pills-settings.json).

---

📚 Основные возможности

💊 Приёмы

• Список с поиском по названию, дозировке и описанию
• Разовое напоминание по дате и времени
• Режим «уведомлять каждый день»
• Редактирование и удаление
• Подстановка ранее использованных препаратов и дозировок

🔔 Будильник

• Окно подтверждения поверх остальных приложений
• Системное уведомление в шторке
• В настройках можно включить только окно, только уведомление или оба способа
• На Android окно рисуется поверх других приложений (поверх всех окон), приложение остаётся в фоне
• Звук до закрытия окна / подтверждения
• Отложить на 5 минут

🔊 Звуки

• Набор мягких коротких сигналов
• Загрузка своей музыки (mp3 / wav / ogg / m4a и др.)
• Предпросмотр в настройках

⚙️ Настройки

• Тема: тёмная / светлая
• Способ напоминания: окно поверх всех, уведомление или оба
• Выбор звука будильника
• Управление своими загруженными треками

---

⬆️ Обновления

Windows

Установленная версия (не Portable) проверяет обновления при запуске и из Настроек.

1. Появится статус о новой версии.
2. Скачайте обновление в настройках и установите (перезапуск).

Portable обновляется только вручную с Releases.

macOS

Автоустановка через ShipIt недоступна (сборка без подписи Apple).
При новой версии приложение предложит открыть GitHub Releases — скачайте новый .dmg и замените приложение в Программах.

Linux

AppImage проверяет обновления при запуске и из Настроек (нужен latest-linux.yml в релизе).
.deb — обновляйте вручную с Releases.

Android

Тот же источник, что и на ПК: GitHub Releases. В Настройках → «Проверить обновления» приложение скачает PillsNative-android-….apk и откроет установщик. Один раз разрешите установку из этого приложения (неизвестные источники).

Либо скачайте APK вручную с Releases и установите поверх текущей версии.

---

🔐 Данные и приватность

• Расписание и настройки хранятся только локально на устройстве.
• Нет облачной синхронизации и аккаунтов.
• Свои звуки копируются в Documents/pills-custom-sounds.

---

🛟 Проблемы?

Ситуация	Что сделать
Не пришло напоминание	Проверьте дату/время, ежедневный режим и что приложение не завершено принудительно
Нет звука	Выберите другой сигнал в настройках или загрузите свой файл
На Mac «повреждено»	ПКМ → Открыть или xattr -cr для .app
SmartScreen (Win)	Подробнее → Выполнить в любом случае
Android не ставит APK	Разрешите установку из неизвестных источников
Нет уведомлений (Android)	В настройках приложения разрешите уведомления, точные будильники и окно поверх других приложений. В батарее отключите ограничения / разрешите автозапуск. Не «останавливайте» приложение принудительно
Пустой список после перезапуска (Android)	Обновите APK (данные пишутся в Preferences). Старые локальные данные могли теряться в WebView
Вопросы и баги	Issues

---

🛠️ Для разработчиков

git clone https://github.com/GoblinThug/pillsnative.git
cd pillsnative
npm install
npx electron .
# или
npm start

Локальная сборка:

npm run dist:win       # Windows → release/
npm run dist:mac       # macOS (нужен Mac)
npm run dist:linux     # Linux → AppImage + deb
npm run mobile:prepare # веб-ассеты для Capacitor

Релиз через GitHub Actions

Workflow .github/workflows/release.yml собирает Windows, macOS, Linux и Android через electron-builder и публикует GitHub Release.

1. Поднимите version в package.json.
2. Закоммитьте и запушьте в main.
3. Actions → Release создаст тег vX.Y.Z (если нужно) и релиз PillsNative X.Y.Z, затем зальёт артефакты (latest.yml, latest-mac.yml, latest-linux.yml, Setup/Portable, DMG/ZIP, AppImage/deb, APK).

Пуш тега v* или ручной Run workflow тоже запускают публикацию.

Каждый пуш в main публикует релиз для текущей версии из package.json.
Чтобы вышла новая версия — сначала измените version, потом пуш.

---

🇬🇧 English

✨ What it is

PillsNative is a local medication reminder for Windows, macOS, Linux, and Android: schedules, tray presence, an always-on-top alarm window, and custom sounds.

	Feature
💊	Dose list with search
⏰	One-shot and daily reminders
🔔	Overlay over other apps, system notification, or both
🔊	Soft built-in chimes and custom music upload
📝	Suggestions for previously used drugs/dosages
🎨	Dark / light theme
📥	System tray background mode
📱	Android build via Capacitor

Repo version: 3.0.2 (always check Releases for the latest).

---

⬇️ Download & install

Prebuilt packages: GitHub Releases →

🪟 Windows

File	Use when
Squirrel / Setup .exe	Normal install — recommended
…-win32-…zip	Portable archive

⚠️ SmartScreen may warn. If you trust the GitHub build: More info → Run anyway.

🍎 macOS

File	Use when
.dmg	Install via disk image
…-darwin-….zip	App archive

⚠️ Builds are not Apple Developer ID signed. Use Right-click → Open or xattr -cr on the .app.

🐧 Linux

File	Use when
.deb	Debian / Ubuntu
.rpm	Fedora / openSUSE
…-linux-….zip	Portable archive

🤖 Android

File	Use when
PillsNative-android-….apk	Sideload install

---

🚀 Quick start

1. Open PillsNative.
2. Tap Add dose.
3. Fill drug, dosage, date/time (or enable daily).
4. Save — you’ll get reminded on time.
5. On alarm: Taken or Snooze 5 min.

Data stays local in Documents (pills.json, pills-settings.json).

---

📚 Main features

• Dose CRUD with search
• Daily or one-shot schedules
• Alarm confirmation window with looping sound
• Built-in soft sounds + custom uploads
• Autocomplete from previous drugs/dosages
• Dark / light theme
• Tray hide/restore

---

🔐 Privacy

• Everything is stored locally.
• No accounts, no cloud sync.
• Custom sounds live under Documents/pills-custom-sounds.

---

🛟 Troubleshooting

Issue	What to try
Missed reminder	Check schedule; keep the app running (tray is fine)
No sound	Pick another chime or upload your own
macOS “damaged”	Right-click → Open / xattr -cr
Windows SmartScreen	More info → Run anyway
Android install blocked	Allow unknown sources
No notifications (Android)	Allow notifications, exact alarms, display over other apps, and disable battery restrictions. Don’t force-stop the app
Empty list after restart (Android)	Update the APK (data is stored in Preferences). Older builds could lose WebView localStorage
Bugs	Issues

---

🛠️ For developers

git clone https://github.com/GoblinThug/pillsnative.git
cd pillsnative
npm install
npx electron .

Local build:

npm run make
npm run mobile:prepare

Release via GitHub Actions

.github/workflows/release.yml builds Windows + macOS + Linux + Android and publishes a GitHub Release titled PillsNative X.Y.Z.

1. Bump version in package.json.
2. Commit and push to main.
3. Actions creates tag vX.Y.Z if needed and uploads artifacts.

Every push to main publishes for the current package.json version — bump version before pushing when you want a new release number.

---

PillsNative · by Goblin_Thug
Downloads · GitHub · Issues