FFXIV Queue Pop LINE Notifier

This is a Windows tool that automatically detects configured Duty Finder UI images, such as the "Wait" and "辞退" buttons that appear when a queue pops in FINAL FANTASY XIV, and sends a notification to LINE. With this, you won’t miss your queue even when you step away from the screen.

---

🧭 Overview

This tool brings the specified game window to the foreground, then continuously scans the entire primary monitor. When a pre-configured image is detected, it attempts to send a push notification to your designated LINE account via the LINE Messaging API.

---

✨ Features

• Automatic Screen Image Detection: Uses pyautogui and opencv-python to detect images on the screen with high accuracy.
• Multi-scale Template Matching: Absorbs differences in resolution and scaling by scanning at multiple scales.
• Push Notifications to LINE: Instantly receive queue pop notifications in LINE.
• Auto Focus on Startup: Brings the target game window to the foreground and gives it focus when the script starts.
• Easy Configuration: Just edit the config.ini file to change your access token, target window, and other settings.

---

📋 Requirements

• OS: Windows 10/11
• Python: 3.10+

---

🛠️ Installation

1. Clone or Download the Repository

   git clone https://github.com/BEROCHLU/ffxiv-queuepop-notifier
   cd ffxiv-queuepop-notifier

2. Install Required Libraries

   In Command Prompt or PowerShell, install all dependencies listed in requirements.txt:

   pip install -r requirements.txt

---

▶️ Usage

1. 💬 Preparing LINE

This tool uses the LINE Messaging API. To receive notifications, follow these steps:

1. Creating a LINE Official Account

   • Create a LINE Official Account and add it as a friend.
   • Click on “Use Messaging API.”
   • Create a provider and open LINE Developers.

2. Issuing a Channel Access Token

   • Log in to the LINE Developers Console, and open the channel from the provider you created.
   • In the “Messaging API settings” tab of the channel, issue a long-term channel access token. You will later set this token in config.ini.

3. Get Your User ID

   • In the channel’s “Basic settings” tab, scroll down to the “Your user ID” section.
   • The string starting with U shown there is your User ID. You will also set this in config.ini.

---

2. 🖼️ Preparing Detection Images

Save screenshots of the images you want to detect in the image folder.

• By default, jitai_scale100.png (the "辞退" button) and wait_scale120.png (the "Wait" button) are configured.
• The script performs multi-scale matching (0.6×–1.4×), so minor differences in monitor scaling are absorbed automatically. If detection still fails, capture a clearer screenshot and edit the IMAGE_PATHS dictionary in line_notifier.py.

---

3. ⚙️ Editing the Configuration File

Copy config_sample.ini to config.ini and edit it with a text editor according to your environment:

[LINE]
# Your Channel Access Token from Step 1
ACCESS_TOKEN = YOUR_CHANNEL_ACCESS_TOKEN

# Your User ID from Step 1
USER_ID = YOUR_USER_ID

# Title of the window to monitor
WINDOW_TITLE = FINAL FANTASY XIV

# Interval (seconds) between detection attempts
INTERVAL_SEC = 0.5

# Detection accuracy threshold (max 1.0)
CONFIDENCE = 0.90

---

4. ▶️ Running the Script

Once settings are complete, run the script:

python line_notifier.py

The script will start monitoring the screen. When the specified image is detected, the script will attempt to send a LINE notification, log any send error, and then automatically terminate.

If you want to stop monitoring manually, press Ctrl + C in the console where the script is running.

---

5. 🔔 Device Settings for Reliable Notifications

Check the following settings on your device to ensure you receive LINE notifications:

• Wi-Fi may cause delays, so disable Wi-Fi and use mobile data for LINE notifications.
• Allow LINE to auto-start in the background.
• Exclude LINE from battery saver restrictions.

---

📝 Notes

• LINE Messaging API allows up to 200 free messages per month.
• Image detection works only on the primary monitor in multi-monitor setups.

---

⚠️ Disclaimer

• This tool works on Windows only.
• This tool does not interfere with the game’s memory or files, but use it at your own risk. The author assumes no responsibility for any damages caused by using this tool.
• If the game client is updated and the UI changes, image recognition may fail. In that case, capture new images for detection.

---

📄 License

This project is licensed under the MIT License.