FreeTube/README.md

71 lines
4.5 KiB
Markdown
Raw Normal View History

2020-02-16 05:07:24 +01:00
<p align="center">
<img src="https://freetubeapp.github.io/images/logoColor.png" width=500 align="center">
</p>
# The FreeTube Vue.js Rewrite
2020-02-17 03:13:24 +01:00
FreeTube is an open source desktop YouTube player built with privacy in mind. This repository specifically is about a rewrite of FreeTube that is actively being worked on. FreeTube will be rewritten from the ground up to take advantage of better coding practices and to make proper use of Vue.js compared to the previous code base. You can read more about why a rewrite is in development over at the related [blog post](https://write.as/freetube/behind-the-scenes-the-rewrite-also-code-release).
2020-02-16 05:07:24 +01:00
2020-02-16 19:35:17 +01:00
This version of FreeTube is not finished. It is in active development and a lot of features (Even ones that are already implemented in FreeTube) are missing. Almost all features are being remade.
2020-02-16 05:07:24 +01:00
## Contributing
Since the code base is smaller and ever expanding. Now is a great time to get involved with contributing to FreeTube. There are a lot of things that need to be done right now and the more help we can get the better.
2020-02-16 19:45:00 +01:00
Check out the [getting started](https://github.com/FreeTubeApp/FreeTube-Vue/wiki/Getting-Started) page over on the wiki on how to get your environment setup. Since this is a rewrite, that means that there are things that we'd like to avoid to prevent the same issues from the old code base. Because of this, there are some coding standards that we'd like to keep while working on this rewrite.
2020-02-16 05:07:24 +01:00
Enough of the rewrite has been done to hopefully provide code examples of what we'd like to see moving forward. Just because standards are already made, it doesn't mean that I'm not open to suggestions for changing things. I would love to hear your thoughts on if you believe that something about our methods can be improved on.
## What Needs to be Done?
Like I mentioned above, there are a lot of things that need to be done. I have created some issues over at the [issues](https://github.com/FreeTubeApp/FreeTube-Vue/issues) page to give a quick rundown on what needs to be done as well as what the requirements are in order for those issues to be considered complete. I will make more issues with more requirements as progress is made.
2020-02-16 05:07:24 +01:00
At this time, here is the list of things to do/need to do:
- [x] Setup App Environment
- [x] Basic App Structure and Layout
- [x] Video Layout (Along with Channel and Playlist Layout)
- [x] Search / Search View (Along with Filters)
- [x] Search Suggestions
2020-02-16 05:07:24 +01:00
- [x] Channel View
- [x] Channel Search
- [x] Trending Page
- [x] Most Popular Page
- [x] Playlist View
- [x] Video Watch Page (Recommendations, Comments)
- [x] Video player logic (Switching formats / quality, live video, fallback logic)
- [x] Playlist logic (Autoplay next video, shuffle list)
- [x] Database Setup and Logic (Updating and creating data)
- [x] Settings Page
- [x] Subscriptions Page and Logic
2020-02-16 05:07:24 +01:00
- [ ] Playlists Page (Will allow for creating user playlists. Will replace the "Favorites" Page)
- [x] History Page and Logic
- [x] Profile Page and Logic
2020-02-16 05:07:24 +01:00
- [ ] Misc. Adjustments and Settings
- [ ] Packaging and Testing
2020-02-16 05:07:24 +01:00
2020-02-16 19:35:17 +01:00
This list is somewhat in order of when I plan on working on each thing. Obviously things can change and anyone is welcome to work on whatever they like.
I will add more things to do as progress gets made. For now what I have listed out should be more than enough.
2020-08-18 04:19:47 +02:00
## Localization
<a href="https://hosted.weblate.org/engage/free-tube/?utm_source=widget">
<img src="https://hosted.weblate.org/widgets/free-tube/-/translations/multi-blue.svg" alt="Translation status" />
</a>
Want to help translate FreeTube into your native language? We're now accepting translations via Weblate! Click on the chart above to learn how to get involved.
2020-02-16 19:35:17 +01:00
## Contact
2020-08-03 10:48:19 +02:00
To chat about the FreeTube rewrite or to ask questions, we encourage you to join our [Matrix Community](https://app.element.io/#/group/+freetube:matrix.org). I will be there actively working on the rewrite and will be available to help you get started. Alternatively, you can email me at FreeTubeApp@protonmail.com.
2020-02-16 19:35:17 +01:00
## License
2020-04-14 02:48:00 +02:00
[![GNU AGPLv3 Image](https://www.gnu.org/graphics/agplv3-155x51.png)](https://www.gnu.org/licenses/agpl-3.0.html)
2020-02-16 19:35:17 +01:00
FreeTube is Free Software: You can use, study share and improve it at your
will. Specifically you can redistribute and/or modify it under the terms of the
2020-04-14 02:48:00 +02:00
[GNU Affero General Public License](https://www.gnu.org/licenses/agpl-3.0.html) as
2020-02-16 19:35:17 +01:00
published by the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.