|
| 1 | +# ❓ Frequently Asked Questions (FAQ) |
| 2 | + |
| 3 | +## 🔍 General Questions |
| 4 | + |
| 5 | +### Q: What is Hikari TikTok Downloader? |
| 6 | +**A:** Hikari is a modern, user-friendly application that allows you to download TikTok videos to your computer. It features a clean interface with TikTok-themed colors and multiple download engines for maximum compatibility. |
| 7 | + |
| 8 | +### Q: Is Hikari free to use? |
| 9 | +**A:** Yes! Hikari is free for personal use under the AGPLv3 license. Commercial use requires a separate license. See `DUAL_LICENSING_DETAILS.txt` for more information. |
| 10 | + |
| 11 | +### Q: What platforms does Hikari support? |
| 12 | +**A:** Hikari works on Windows, macOS, and Linux systems with Python 3.7 or higher. |
| 13 | + |
| 14 | +### Q: Is it safe to use? |
| 15 | +**A:** Yes, Hikari is completely safe. It doesn't collect personal data, doesn't contain malware, and only connects to TikTok servers for downloads. Always download from the official GitHub repository. |
| 16 | + |
| 17 | +--- |
| 18 | + |
| 19 | +## 📥 Download Questions |
| 20 | + |
| 21 | +### Q: What video formats can I download? |
| 22 | +**A:** Hikari downloads videos in MP4 format, which is compatible with most devices and media players. |
| 23 | + |
| 24 | +### Q: Can I download videos without watermarks? |
| 25 | +**A:** Yes! When using the yt-dlp engine (recommended), videos are downloaded without TikTok watermarks. |
| 26 | + |
| 27 | +### Q: What quality options are available? |
| 28 | +**A:** Hikari automatically downloads in the highest available quality (up to 1080p) to ensure you get the best possible video quality with optimal file size. |
| 29 | + |
| 30 | +### Q: Can I download private videos? |
| 31 | +**A:** No, Hikari can only download publicly available videos. Private or deleted videos cannot be accessed. |
| 32 | + |
| 33 | +### Q: Can I download multiple videos at once? |
| 34 | +**A:** Currently, Hikari downloads one video at a time. Batch downloading is not supported in this version. |
| 35 | + |
| 36 | +### Q: Why do some downloads fail? |
| 37 | +**A:** Downloads may fail due to: |
| 38 | +- Invalid or expired URLs |
| 39 | +- Private/deleted videos |
| 40 | +- Regional restrictions |
| 41 | +- Network connectivity issues |
| 42 | +- Outdated download engines |
| 43 | + |
| 44 | +**Solution:** Try switching engines or updating libraries. |
| 45 | + |
| 46 | +--- |
| 47 | + |
| 48 | +## 🔧 Technical Questions |
| 49 | + |
| 50 | +### Q: What's the difference between the download engines? |
| 51 | +**A:** |
| 52 | +- **yt-dlp (Recommended)**: Higher success rate, watermark-free downloads, more stable |
| 53 | +- **TikTok API**: Faster downloads, lower resource usage, but may include watermarks |
| 54 | + |
| 55 | +### Q: How do I update the download engines? |
| 56 | +**A:** Click the "Update Libraries" button in the application, or run: |
| 57 | +```bash |
| 58 | +pip install --upgrade yt-dlp |
| 59 | +``` |
| 60 | + |
| 61 | +### Q: Where are downloaded videos saved? |
| 62 | +**A:** By default, videos are saved to a "Downloads" folder in the application directory. You can change this using the "Browse" button. |
| 63 | + |
| 64 | +### Q: Can I change the file names? |
| 65 | +**A:** Currently, files are automatically named using the video title from TikTok. Custom naming is not available in this version. |
| 66 | + |
| 67 | +### Q: Why is the application slow to start? |
| 68 | +**A:** First-time startup may be slower as Python loads all dependencies. Subsequent launches should be faster. |
| 69 | + |
| 70 | +--- |
| 71 | + |
| 72 | +## 🛠️ Troubleshooting |
| 73 | + |
| 74 | +### Q: "Python not found" error - what do I do? |
| 75 | +**A:** Install Python 3.7+ from [python.org](https://python.org) and make sure to check "Add Python to PATH" during installation. |
| 76 | + |
| 77 | +### Q: "Module not found" errors during setup? |
| 78 | +**A:** Try: |
| 79 | +1. Run `python setup.py` again |
| 80 | +2. Install manually: `pip install customtkinter pillow yt-dlp requests` |
| 81 | +3. Use `python -m pip install` instead of just `pip` |
| 82 | + |
| 83 | +### Q: The application window doesn't appear? |
| 84 | +**A:** |
| 85 | +1. Check if Python is properly installed |
| 86 | +2. Try running `python test_app.py` to check components |
| 87 | +3. Ensure you have a desktop environment (not just command line) |
| 88 | +4. Try running as administrator |
| 89 | + |
| 90 | +### Q: Downloads keep failing with yt-dlp? |
| 91 | +**A:** |
| 92 | +1. Update yt-dlp: Click "Update Libraries" |
| 93 | +2. Try the TikTok API engine instead |
| 94 | +3. Check if the video URL is still valid |
| 95 | +4. Verify your internet connection |
| 96 | + |
| 97 | +### Q: "Permission denied" when downloading? |
| 98 | +**A:** |
| 99 | +1. Choose a different output folder (like Desktop or Documents) |
| 100 | +2. Run the application as administrator |
| 101 | +3. Check if antivirus is blocking the download |
| 102 | + |
| 103 | +### Q: The interface looks broken or weird? |
| 104 | +**A:** |
| 105 | +1. Update CustomTkinter: `pip install --upgrade customtkinter` |
| 106 | +2. Check your display scaling settings |
| 107 | +3. Try running on a different monitor if using multiple displays |
| 108 | + |
| 109 | +--- |
| 110 | + |
| 111 | +## 🔒 Legal & Privacy Questions |
| 112 | + |
| 113 | +### Q: Is it legal to download TikTok videos? |
| 114 | +**A:** You should only download: |
| 115 | +- Your own videos |
| 116 | +- Videos you have explicit permission to download |
| 117 | +- Videos for personal use under fair use guidelines |
| 118 | + |
| 119 | +Always respect copyright laws and TikTok's Terms of Service. |
| 120 | + |
| 121 | +### Q: Does Hikari collect my data? |
| 122 | +**A:** No! Hikari: |
| 123 | +- Doesn't collect personal information |
| 124 | +- Doesn't track your usage |
| 125 | +- Doesn't send data to external servers |
| 126 | +- Only connects to TikTok for downloads |
| 127 | + |
| 128 | +### Q: Can I use Hikari for commercial purposes? |
| 129 | +**A:** Commercial use requires a separate license. Contact Gary19gts through Ko-fi for commercial licensing options. |
| 130 | + |
| 131 | +### Q: What about TikTok's Terms of Service? |
| 132 | +**A:** Users are responsible for complying with TikTok's Terms of Service. Hikari is a tool - how you use it is your responsibility. |
| 133 | + |
| 134 | +--- |
| 135 | + |
| 136 | +## 💼 Business & Licensing |
| 137 | + |
| 138 | +### Q: Can I integrate Hikari into my software? |
| 139 | +**A:** Yes, but you'll need a commercial license. Contact Gary19gts for licensing terms and pricing. |
| 140 | + |
| 141 | +### Q: Can I modify the source code? |
| 142 | +**A:** Under AGPLv3: Yes, but you must share your modifications under the same license. |
| 143 | +Under Commercial License: Yes, with no sharing requirements. |
| 144 | + |
| 145 | +### Q: Can I redistribute Hikari? |
| 146 | +**A:** Under AGPLv3: Yes, with full source code and license notices. |
| 147 | +Under Commercial License: According to your license agreement. |
| 148 | + |
| 149 | +### Q: How much does a commercial license cost? |
| 150 | +**A:** Pricing varies based on use case and company size. Contact Gary19gts through Ko-fi for a quote. |
| 151 | + |
| 152 | +--- |
| 153 | + |
| 154 | +## 🆘 Getting Help |
| 155 | + |
| 156 | +### Q: Where can I get support? |
| 157 | +**A:** |
| 158 | +1. Check this FAQ first |
| 159 | +2. Read the `INSTRUCTIONS.md` file |
| 160 | +3. Run `python test_app.py` for diagnostics |
| 161 | +4. Check the `logs/` folder for error details |
| 162 | +5. Contact Gary19gts through Ko-fi for persistent issues |
| 163 | + |
| 164 | +### Q: How do I report bugs? |
| 165 | +**A:** Contact Gary19gts through Ko-fi with: |
| 166 | +- Description of the problem |
| 167 | +- Steps to reproduce |
| 168 | +- Error messages (if any) |
| 169 | +- Your system information |
| 170 | + |
| 171 | +### Q: Can I request new features? |
| 172 | +**A:** Yes! Feature requests can be submitted through Ko-fi. Popular requests may be added in future versions. |
| 173 | + |
| 174 | +### Q: How often is Hikari updated? |
| 175 | +**A:** Updates are released as needed for: |
| 176 | +- Bug fixes |
| 177 | +- Security patches |
| 178 | +- New features |
| 179 | +- Compatibility improvements |
| 180 | + |
| 181 | +--- |
| 182 | + |
| 183 | +## 💝 Support & Donations |
| 184 | + |
| 185 | +### Q: How can I support the project? |
| 186 | +**A:** The best way to support Hikari is through Ko-fi donations. Even small amounts help with development costs and motivation! |
| 187 | + |
| 188 | +### Q: What do donations go toward? |
| 189 | +**A:** Donations help with: |
| 190 | +- Development time |
| 191 | +- Server costs for testing |
| 192 | +- Software licenses and tools |
| 193 | +- Keeping the project free for personal use |
| 194 | + |
| 195 | +### Q: Are there other ways to help? |
| 196 | +**A:** Yes! You can: |
| 197 | +- Share Hikari with friends who might find it useful |
| 198 | +- Provide feedback and suggestions |
| 199 | +- Report bugs you encounter |
| 200 | +- Leave positive reviews |
| 201 | + |
| 202 | +--- |
| 203 | + |
| 204 | +## 💝 Support the Project |
| 205 | + |
| 206 | +Thank you for using **Hikari TikTok Downloader**! |
| 207 | +Made with ❤️ by Gary19gts |
| 208 | + |
| 209 | +If Hikari has been helpful to you, please consider supporting its development: |
| 210 | + |
| 211 | +☕ **Buy me a coffee on Ko-fi** → [https://ko-fi.com/gary19gts](https://ko-fi.com/gary19gts) |
| 212 | + |
| 213 | +✨ Even the smallest donation can bring a big light during these tough times. |
| 214 | +Even $1 can help more than you think 😀🙏 |
| 215 | + |
| 216 | +Thank you so much for standing with me! ✨ |
| 217 | + |
| 218 | +--- |
| 219 | + |
| 220 | +*Last updated: October 2025* |
| 221 | +*If your question isn't answered here, feel free to reach out through Ko-fi!* |
0 commit comments