Skip to content

Commit 9a95623

Browse files
authored
Add files via upload
1 parent d647fe8 commit 9a95623

33 files changed

Lines changed: 4569 additions & 616 deletions

DUAL LICENSE

Lines changed: 701 additions & 0 deletions
Large diffs are not rendered by default.

FAQ.md

Lines changed: 221 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,221 @@
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

Comments
 (0)