📱 Instagram Reels Downloader для Termux

Простой, но мощный скрипт для скачивания Instagram Reels прямо на ваш Android-смартфон через Termux. Никаких заморочек - просто копируете ссылку на рилс и готово! 🚀

🔥 Фишки

• Скачивание Instagram Reels в один клик
• Автоматическое сохранение в папку Movies/Instagram
• Push-уведомления о статусе загрузки
• Сохранение актуальных метаданных видео
• Виджет для быстрого доступа с главного экрана
• Не требует логина в Instagram

📱 Требования

• Android смартфон
• F-Droid - безопасный магазин приложений для Android (скачать тут)
• Установленные через F-Droid приложения:
  • Termux
  • Termux:API
  • Termux:Widget
• Разрешения для Termux:
  • Доступ к хранилищу
  • Отображение поверх других приложений

🛠️ Установка

⚠️ Важно: Устанавливайте все приложения Termux только через F-Droid! Версии из Google Play больше не поддерживаются и могут работать некорректно.

1. Установите все необходимые приложения через F-Droid:

   • Termux
   • Termux:API
   • Termux:Widget

2. Настройте разрешения для Termux:

   • Откройте Настройки Android
   • Перейдите в раздел "Приложения" (или "Управление приложениями")
   • Найдите в списке Termux
   • Выберите "Другие разрешения" (или "Дополнительные разрешения")
   • Включите переключатель "Отображать поверх других приложений"

📝 Примечание: Названия разделов в настройках Android могут отличаться в зависимости от производителя смартфона и версии системы. Если не можете найти нужный пункт - воспользуйтесь поиском по настройкам, указав "Termux" или "поверх других приложений".

3. Откройте Termux и вставьте следующую команду:

curl -s https://raw.githubusercontent.com/sandexzx/InstagramDownloaderWidget/main/SetupDownloader.sh | bash

4. Дождитесь завершения установки. Скрипт автоматически:
   • Установит все необходимые зависимости
   • Создаст нужные директории
   • Настроит скрипты
   • Сделает их исполняемыми

🎯 Настройка виджета

После успешной установки скрипта необходимо добавить виджет на главный экран:

1. На главном экране Android найдите свободное место
2. Нажмите и удерживайте это место до появления меню
3. Выберите "Виджеты" (или проведите по экрану, чтобы перейти к списку виджетов)
4. Найдите в списке "Termux Widget" (может потребоваться прокрутка)
5. Выберите виджет и перетащите его на главный экран
6. В появившемся списке скриптов выберите "download_reel"

Теперь виджет готов к использованию! Просто скопируйте ссылку на понравившийся рилс и нажмите на виджет - скрипт сделает всю работу за вас 😎

💫 Как использовать

Через виджет (рекомендуется):

1. Скопируйте ссылку на понравившийся рилс
2. Нажмите на виджет "Download Reel" на главном экране
3. Готово! Видео появится в папке Movies/Instagram

Через терминал:

~/.shortcuts/download_reel

📂 Структура файлов

└── $HOME
    ├── scripts/
    │   └── download_reel.py    # Основной скрипт загрузки
    ├── .shortcuts/
    │   └── download_reel       # Скрипт-шорткат для виджета
    └── storage/shared/Movies/Instagram/
        └── ...                 # Загруженные видео

🔧 Технические детали

Скрипт использует:

• instaloader для загрузки контента
• ffmpeg для работы с метаданными
• termux-api для уведомлений и доступа к буферу обмена

⚠️ Важно

• Скрипт работает только с публичными рилсами
• Используйте ответственно и уважайте авторские права
• Загруженный контент предназначен только для личного использования

🐛 Решение проблем

1. Ошибка "Invalid Link"

   • Убедитесь, что ссылка начинается с "instagram.com" и содержит "/reel/"

2. Ошибка "No URL provided"

   • Проверьте, что ссылка скопирована в буфер обмена

3. Нет доступа к хранилищу

   termux-setup-storage

4. Виджет не работает

   • Проверьте, установлен ли Termux:Widget
   • В настройках Android разрешите Termux отображаться поверх других приложений
   • Перезапустите Termux после выдачи разрешений

📝 Лицензия

Делайте что хотите, just give credit 😉

🤝 Вклад в проект

Баги нашли? Есть идеи по улучшению? Welcome:

1. Форкните репозиторий
2. Создайте ветку для фичи (git checkout -b feature/AmazingFeature)
3. Закоммитьте изменения (git commit -m 'Add some AmazingFeature')
4. Пушните в ветку (git push origin feature/AmazingFeature)
5. Откройте Pull Request

📞 Связь

• Создайте Issue в этом репозитории
• Напишите мне в Telegram

📱 Instagram Reels Downloader for Termux

A lightweight yet powerful script for downloading Instagram Reels directly to your Android smartphone via Termux. No complications - just copy the reel link and you're good to go! 🚀

🔥 Features

• One-click Instagram Reels downloading
• Automatic saving to Movies/Instagram folder
• Push notifications for download status
• Up-to-date video metadata preservation
• Home screen widget for quick access
• No Instagram login required

📱 Requirements

• Android smartphone
• F-Droid - secure Android app store (download here)
• The following apps installed via F-Droid:
  • Termux
  • Termux:API
  • Termux:Widget
• Required Termux permissions:
  • Storage access
  • Display over other apps

🛠️ Installation

⚠️ Important: Install all Termux applications exclusively through F-Droid! Google Play versions are no longer maintained and may not work correctly.

1. Install all required applications via F-Droid:

   • Termux
   • Termux:API
   • Termux:Widget

2. Configure Termux permissions:

   • Open Android Settings
   • Go to "Apps" (or "App management")
   • Find Termux in the list
   • Select "Additional permissions" (or "Other permissions")
   • Enable "Display over other apps" toggle

📝 Note: The names of settings sections may vary depending on your smartphone manufacturer and Android version. If you can't find the required option - use the settings search function, looking for "Termux" or "display over other apps".

3. Open Termux and paste the following command:

curl -s https://raw.githubusercontent.com/sandexzx/InstagramDownloaderWidget/main/SetupDownloader.sh | bash

4. Wait for the installation to complete. The script will automatically:
   • Install all necessary dependencies
   • Create required directories
   • Set up scripts
   • Make them executable

🎯 Widget Setup

After successfully installing the script, you need to add the widget to your home screen:

1. Find an empty space on your Android home screen
2. Press and hold that space until a menu appears
3. Select "Widgets" (or swipe to access the widgets list)
4. Look for "Termux Widget" in the list (you might need to scroll)
5. Select and drag the widget to your home screen
6. From the scripts list that appears, choose "download_reel"

Your widget is now ready to use! Just copy any reel link and tap the widget - the script will handle everything else 😎

💫 How to Use

Via Widget (Recommended):

1. Copy the link of the reel you want to download
2. Tap the "Download Reel" widget on your home screen
3. Done! The video will appear in the Movies/Instagram folder

Via Terminal:

~/.shortcuts/download_reel

📂 File Structure

└── $HOME
    ├── scripts/
    │   └── download_reel.py    # Main download script
    ├── .shortcuts/
    │   └── download_reel       # Widget shortcut script
    └── storage/shared/Movies/Instagram/
        └── ...                 # Downloaded videos

🔧 Technical Details

The script utilizes:

• instaloader for content downloading
• ffmpeg for metadata manipulation
• termux-api for notifications and clipboard access

⚠️ Important Notes

• Script works only with public reels
• Use responsibly and respect copyright
• Downloaded content is for personal use only

🐛 Troubleshooting

1. "Invalid Link" Error

   • Ensure the link starts with "instagram.com" and contains "/reel/"

2. "No URL provided" Error

   • Verify that the link is copied to clipboard

3. Storage Access Issues

   termux-setup-storage

4. Widget not working

   • Verify that Termux:Widget is installed
   • Enable "Display over other apps" permission for Termux in Android settings
   • Restart Termux after granting permissions

📝 License

Do whatever you want, just give credit 😉

🤝 Contributing

Found bugs? Have ideas for improvements? You're welcome to contribute:

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📞 Contact

• Create an Issue in this repository
• Reach out via Telegram

⚙️ Dependencies

The script requires the following Python packages:

• instaloader
• beautifulsoup4
• requests
• ffmpeg-python

And the following Termux packages:

• python
• termux-api
• ffmpeg

🔍 How It Works

The script performs the following operations:

1. Extracts the reel's shortcode from the URL
2. Downloads the video using instaloader
3. Updates the video metadata to current date/time
4. Moves the file to the Movies/Instagram directory
5. Sends a notification about the download status
6. Cleans up temporary files

🆘 Common Issues and Solutions

1. Download fails immediately

   • Check your internet connection
   • Verify that the reel is from a public account
   • Ensure Termux has storage permissions

2. Widget doesn't appear

   • Reinstall Termux:Widget
   • Ensure the shortcut script is properly placed in ~/.shortcuts

3. Video doesn't appear in gallery

   • Try running termux-media-scan manually
   • Check if the Movies/Instagram directory exists
   • Verify storage permissions

📱 Compatibility

• Works on Android 7.0 and above
• Tested on various Android distributions
• Compatible with most modern Android file managers