saptarshisarkar12/drifty

Drifty is an Open-Source Interactive File Downloader System built with Java

About 🔥

• Drifty is an open-source interactive File Downloader system built using Java.
• It is both available in Command-line Interface (CLI) and Graphical User Interface (GUI) mode.

Demo

See the video below to know how to use the application. For any help, you can open an issue.

For Batch Downloading via Drifty CLI, the path to a YAML file has to be provided to it. It should have the following structure :

links: ["", ""] # [REQUIRED] - Links to the files to be downloaded
# Below parameters are OPTIONAL
fileNames: [""] # Will be auto-retrieved if not provided
# If the directory is not provided, the files will be downloaded in the default downloads folder.
directory: [""] # Use 'directory' when all the files to be downloaded in the same folder.
directories: [""] # Use 'directories' when the download folder is different for each of the files

Drifty GUI

GUI.mp4

Drifty CLI

CLI.mp4

Tech Stack

The Application Drifty is built using the following technologies :

• Java - A programming language for building machine independent applications.

The Website of Drifty is built using the following technologies :

• Next.js - A JavaScript framework for building server-rendered React applications.
• Tailwind CSS - A utility-first CSS framework.

Join the Drifty Testing Program 🚀

Drifty is released in 4 phases, namely Alpha, Beta, Release Candidate, and Stable. If you want to test the unstable (Alpha or Beta) or the mostly stable versions (Release Candidate), you can download the executables for the respective phases from the Drifty website or try the Docker images for the respective phases.
If you find any issues during the testing period, please open an issue or join our Discord Server to share your feedback.

Quickstart 🚀🚀

For Users :

Using Drifty Application executable

1. Visit the Drifty website
   
2. Click on Download
   
3. Choose the Application Type from the dropdown menu (Default option is GUI). To download Drifty CLI, select CLI and to download Drifty GUI, select GUI. Then, click on the Download Now button based on your Operating System (Windows, Linux, macOS). For Windows user, there is an MSI file available for Drifty GUI. You can click on the Prefer the msi? text to download the latest MSI file 🎉.

Tip

If you want to test the unstable (Alpha or Beta) or the mostly stable versions (Release Candidate), you can click on the download button of the respective phase.

4. Navigate to the Downloads folder and execute the downloaded file. If you are installing Drifty GUI, complete the steps in the macOS or Windows MSI installer wizard that appears on your screen.

5. Check out the Demo section for examples of how to use the application.

6. If you like the project, please leave a star on GitHub.

7. For any issues or feature requests, you can join our Discord Server and share your feedback.

Using Drifty Application via Docker 🐋

Tip

• To download files to a specific local directory, you need to mount that directory as a volume for Drifty. For example, if you want to download the file to your home/username/Downloads directory, then, you need to use the volume flag -v /home/username/Downloads:/root/Downloads with the docker command.
• You can also mount -v /home/username/.drifty:/root/.drifty to enable the docker container to store Drifty's data in your local directory, which will make Drifty initialize much faster 🚀⚡.
• For Linux, we recommend using Docker Engine directly instead of running images with Docker Desktop. To do this, add sudo before the docker commands.
• If you want to try unstable (Alpha or Beta) [Alpha releases are not available as of now] or the mostly stable versions (Release Candidate) [Release Candidate releases are not available as of now], you need to use the respective docker image tags. For example, to use the Beta version of Drifty, you need to use the docker image tag beta like ghcr.io/saptarshisarkar12/drifty-cli:beta or ghcr.io/saptarshisarkar12/drifty-gui:beta.

Important

• To run Drifty GUI docker image, you need to do the following 👇
  • For Linux and Windows, please run xhost +local:docker before running the GUI docker image.
  • For macOS, please follow these instructions.

1. Pull the Docker image for Drifty using the below command -
   For Drifty CLI,

   docker pull ghcr.io/saptarshisarkar12/drifty-cli:master

   For Drifty GUI,

   docker pull ghcr.io/saptarshisarkar12/drifty-gui:master

2. Run the docker image using the below command -
   For Drifty CLI,

   docker run ghcr.io/saptarshisarkar12/drifty-cli:master

   For Drifty GUI,

   docker run -e DISPLAY=$DISPLAY --net=host -v /tmp/.X11-unix:/tmp/.X11-unix ghcr.io/saptarshisarkar12/drifty-gui:master

3. Drifty will open, and you can now use it 🎉!

For Contributors :

1. Go to the project link on GitHub, fork this repository and clone your fork into your local directory by running this command in your terminal.

   git clone [email protected]:SaptarshiSarkar12/Drifty.git

   

2. Open an issue ❕ describing the changes you want to make.

3. Make the changes in an IDE (preferably Intellij Idea) and open a Pull Request. Ensure that you have linked the issue to the Pull Request.
4. The Pull Request will be reviewed by the maintainers and merged if approved. ✔

5. Leave a star ⭐ on GitHub if you liked the project.
   
6. You may join our Discord Server to discuss on the changes that you want to bring.

Using Docker 🐋 for Development

Important

For Linux and Windows, please run xhost +local:docker before running the GUI docker image.
For macOS, please follow these instructions to run Drifty GUI docker image.

1. To start Drifty GUI and Drifty CLI with your modified source code, run docker compose run gui and docker compose run cli respectively.
2. The Drifty app will show up on the screen, and you can test it 🎉!

Safety warning ⚠️ while Downloading ⬇️

It is because Microsoft Defender could not verify it is safe as it is not commonly downloaded. Feel free to proceed with the following steps:

• Click on the three dots.
• Click on keep.

• Click Show More.
• Click Keep anyway.

• Now it is downloaded, you can proceed.🎉

Report the file as safe ✔️

You can also provide your feedback to Microsoft Defender by reporting it to be Safe, by following the below steps:

• Click on three dots.
• Click on Report this file as safe instead of clicking on Keep.

• It will take you to Report a download page. You can provide your feedback there.😄

Safety warning ⚠️ while Installing

• For Windows, click on More Info and then Run Anyway as present in the screen below:
• For macOS, click on OK and run sudo spctl --master-disable in your terminal to allow running unsigned apps. Try running Drifty again.
  

Contributing to the project

• We welcome 🤝 your contributions to this Open-Source project.
• Please check the Contributing Guidelines and the Roadmaps for ways to get involved.
• You can also open an issue to report a bug 🐛, request a feature 💡, or suggest an improvement 📈.
• Please follow this project's Code Of Conduct to maintain a respectful and inclusive environment.
• Please note that this project uses Semantic Versioning for its releases.
• Join our Discord Server to stay updated on this project and chat 💬 with the maintainer and the other contributors.

Stats 📊

Support 🙏

Please leave a star ⭐ on this project to support us.

Thanks to all the contributors ❤️

drifty's Issues

[BUG] Fix the navbar animation

Description

Fix

• Navbar animation: the current navbar animation changes very abruptly #
• Change the cursor of the navbar elements to a pointer cursor

Application Version

v1.1.0

Additional information

No response

[BUG] dark mode and things above the header needs to be improved

i can fix that please assign me

[BUG] Failed to create the directory in default download folder

Describe the bug
When the application asks us to download file in default downloads folder and we type 'Y'. It generates error as : 'Failed to create the directory'

To Reproduce
Steps to reproduce the behavior:

1. Download the application at Desktop and open it.
2. Enter the link to the file, take any image from google.
3. Press Y when asking for default downloads folder.
4. A message will pop up as : Default download folder detected and then an error will pop up as : Failed to create the directory.

Expected behavior
It should have downloaded the file in default download folder of windows.

Screenshots

Desktop (please complete the following information):

• OS: Windows 10
• Version 21H2

[DOCS] Reorganising badges in README.md file

How would you improve the documentation? Please describe.

It d look good if the badge are in a more organized manner. And moved to prior to the introduction section.

Additional information

No response

[FEATURE] Adding support for multiple download URLs as input

Is your feature request related to a problem? Please describe.
The users in most cases have to download more than one file, so, in the current version of Drifty, the user can enter maximum one download link and after the file has been downloaded, the application closes.

Describe the solution you'd like
The solution to this problem can be adding arrays to store multiple URLs, respective filenames and respective directories as input. Or, a while loop can also be introduced to run till the user enters stop or the number of files the user wants to download has exceeded.

Additional context
Contributors who want to take over this issue should at first comment below then I will assign them with the task. Multiple assignes can be there.

Moving "Contributing" section after "Demo" in README file

How would you improve the documentation? Please describe.

It would be nice to move the Contributing section after the Demo, as done in all well-known project READMEs. As the page would refer to the Users before it will to the Potential Contributors.

Additional information

No response

[FEATURE] Caching of images and other files in website

Is your feature request related to a problem? Please describe.

No response

Describe the solution you'd like.

Caching the images and other such files for the website.

Application Version

v1.1.0

Screenshots

No response

Additional information

If anyone wants to work on this issue, please comment below and I shall assign you with the task.

[FEATURE] Add support for downloading YouTube videos

Describe the solution you'd like
Currently, the application shows HTTP proxy error while downloading an YouTube video. So, I want to have the application support for downloading YouTube videos. Anyone can contribute, just leave a comment and I will assign you with the task. Please link this issue to your PR.

Additional context
Refer to the FileDownloader.java file to see how it downloads a file and find how you can add support for downloading YouTube videos in that file.

[FEATURE] Remaster the hero section and the nav bar of the website

Description

The website's current hero section and nav bar are good, but I want to up it.
I would like to redesign both.

Application Version

v1.1.0

Additional information

I also am planning to add animations and illustrations to the hero section.

[BUG] The Download Section has different font than other sections

Describe the bug

While all the sections of the website are no using a consistent font-style, the heading section of Downloads is still using some old font, which make it look not consistent with the page style.

Steps To Reproduce

1. Go to Home Page
2. Scroll to Downloads section
3. Check its Heading
4. See the error

Expected Behavior

The Download Section's heading should be consistent with the page and should have similar styling to other sections of the page. This is how UI Designing works. So I would like to work on this issue

Operating System

Windows

Application Version

v1.1.0

Screenshots

Additional information

No response

[FEATURE] Better UI for the dark mode button

Is your feature request related to a problem? Please describe.

Yes. When you click on the dark mode that button blends with the background.

Describe the solution you'd like.

A sticky Floating button for the dark mode so people can shift modes any where in the page

Application Version

v1.1.0

Screenshots

No response

Additional information

No response

[FEATURE] Make a website for the documentation of Drifty

Is your feature request related to a problem? Please describe.
People don't always like to read Documentation from Readme. They want some website which will have a visually appealing look and all the sufficient details of using this application as well as support URLs.

Describe the solution you'd like
A website using html and css containing the documentation present in the README and a navbar should also be present. The support URLs (GitHub issues, My email address, my twitter account for DMs) should be present at the footer.

Additional context
Contributors who want to take over this issue should at first comment below then I will assign them with the task. Multiple assignes can be there. Feel free to contact me for any questions.

[BUG] Need to fix all buttons' transitions & extra scroll

Description

Fix

• All buttons except for the navbar have a very abrupt transition
• The page has an extra horizontal scroll due to the implementation of a video.

If it's okay with you, I can arrange this and send you the PR.

Additional information

No response

[BUG] JNI ERROR

Error in the new release of Drifty

To Reproduce
Steps to reproduce the behavior:

1. Go to 'https://github.com/SaptarshiSarkar12/Drifty/raw/master/Drifty_CLI.exe'
2. Download Drifty for Windows
3. See error

[FEATURE] Add Stars And Forks in the footer of the website

Is your feature request related to a problem? Please describe.

NA

Describe the solution you'd like.

I will add the count of the number of forks and stars of your repository in the footer section of your website.

Application Version

v1.1.0

Screenshots

No response

Additional information

If approved please assign this issue to me.

[FEATURE] Add a CLS function on Java using CMD

Description
In the else if statement adding a cls to clear screen on command line

Edit Buttons![FEATURE]

Is your feature request related to a problem? Please describe.

Button animation have an unfinished kind if look ! as if stuck or in loop ,and the on hover animation and change in color does not match with color scheme of the entire website.

Describe the solution you'd like.

I would love to add a much smoother on hover animation and better colors to buttons.

Application Version

v1.1.0

Screenshots

No response

Additional information

No response

[FEATURE] Rework on the contribute section.

Description

The contribute section seems kinda empty at the moment. I would love to add more content and improve its appearance.

Application Version

v1.1.0

Additional information

No response

[FEATURE] Add the image of Drifty working on the website

Describe alternatives you've considered
Adding background image to the website of Drifty.

Edit Nav Bar [FEATURE]

Is your feature request related to a problem? Please describe.

Nav Bar is too dark and blocks the view to the content!

Describe the solution you'd like.

Edit the Nav Bar with a sleek design to compliment the theme of website.

Application Version

v1.1.0

Screenshots

No response

Additional information

No response

[FEATURE] Making a gui version of Drifty

Is your feature request related to a problem? Please describe.
It's not always loved by users to use console applications, rather they find much interest in using GUI (Graphical User Interface) version of any application.

Describe the solution you'd like
We nees to build a GUI version of the application. We can use JavaFX or swing for that purpose.

Additional context
Contributors who want to take over this issue should at first comment below and then, I would assign them with the task. Multiple assignes can be there.

[FEATURE] Improve the Website UI - Responsive

Is your feature request related to a problem? Please describe.

I would like to work on the entire Website UI and improve it as you can see that there are many things which don't work on the website as well as the UI design is not upto the mark. The Website is not resposive as well as there are many responsive bugs.

Describe the solution you'd like.

I would like to work on the entire website part as a sole developer to improve the application and provide a better user experince for the application.

Application Version

v1.1.0

Screenshots

Additional information

Would gladly contribute to this website as a part of hacktober fest and would love to contribute my share to open source applications.

[BUG] Navigation on website does not lead to anywhere

Describe the bug

The Download Text on the Navbar does not do anything. This should be fixed to take the user to the download section of the page.

Steps To Reproduce

1. Go to https://saptarshisarkar12.github.io/Drifty/
2. Click on the Download text in the Navigation bar

Expected Behavior

I expect to be taken to a page where I can download the tool

Operating System

Windows

Application Version

v1.1.0

Screenshots

No response

Additional information

No response

[DOCS] Edit CONTRIBUTING.md

How would you improve the documentation? Please describe.

edit the contributing.md file which is important for a project, as it tells us the Prerequisite, and steps to contribute to any project.

Additional information

No response

[FEATURE] Adding dark mode to the website

I can add dark mode with a button on the site

Getting unsafe warning while downloading .exe file

Description

Getting "Unsafe" warning while downloading the Drifty_CLI.exe

OS: Windows
Browser: MS Edge

[OTHER] Website README.md

Description

I want to add README.md file inside website folder.

Application Version

v1.1.0

Additional information

Please assign this issue to me

[FEATURE] Add a contact form in the website

Is your feature request related to a problem? Please describe.

Many "Aalsi" peoples may never click on the email or Twitter buttons for contacting to the admin for a short message.

Describe the solution you'd like.

I want to add a contact form in the contact section of the website so that visitors can easily get back to the admin.

Application Version

v1.1.0

Screenshots

No response

Additional information

No response

[FEATURE] Adding the image of Drifty using characters, in the first line of the console

Describe the solution you'd like
I want to add an image of Drifty (might be logo) printed using characters, for the first line of the console.

Additional context
Refer to this image. Here, the logo of the app is printed in the console. Similar thing needs to be done with Drifty.
Contributors who want to take over this issue should at first comment below and then I will assign them with the task.

[BUG] Some items appear smaller in some mobiles

Describe the bug

The text in buttons in some parts of the website appears very small. It includes the more info, contact us and Download section containing the three buttons.

Steps To Reproduce

1. Go to Drifty's Website in MS Edge.
2. Press CTRL + SHIFT + I or open DevTools.
3. Press CTRL + SHIFT + M or Toggle Device Emulation.
4. Click on Dimensions and select iPhone SE or iPhone 12 Pro or Pixel 5 or Samsung Galaxy S8+, etc.
5. See the bug as given in the screenshot below.

Expected Behavior

Texts should have proper size and should be displayed properly.

Operating System

Other

Application Version

v1.1.0

Screenshots

Samsung Galaxy S8+

iPhone SE

Additional information

If anyone wants to work on this issue, you can comment below, and I would assign you with the task.

[FEATURE] Change the look and feel of website

Description

Website's colour system and transitions were previously a bit odd. Changed them a bit.

Application Version

v1.1.0

Additional information

No response

[FEATURE] Add provision to check URLs passed to the Application

Check for user input

whenever the user inputs a link drifty should check if it is in proper URL format or not
for eg.
Enter the link to the file: fs
prompt: enter a valid URL

Changes to organize and fix parts of the website

Is your feature request related to a problem? Please describe.

No response

Describe the solution you'd like.

• add semantic html to the footer
• fix the dark mode toggle ( Currently if you activate the bright mode and reload the page the darkmode toggle is inverted and causes you to have errors when changing themes. )
• delete unused css

Application Version

v1.1.0

Screenshots

No response

Additional information

No response

Make a better footer![FEATURE]

Is your feature request related to a problem? Please describe.

The footer looks kind of very basic and unfinished, also the hero section text is simple .

Describe the solution you'd like.

I would like to change the footer and remove the red color after effect with some matching colors. Change the position of social media buttons and edit the font in hero section text.

Application Version

v1.1.0

Screenshots

No response

Additional information

No response

[FEATURE] Create a feature to make log files for Drifty

Is your feature request related to a problem? Please describe.
A log file helps to better maintain what error has occurred or the request has been processed successfully.

Describe the solution you'd like
A feature to automatically generate log file when the application runs.

Contributors who want to take over this issue should at first comment below and then I will assign them with the task. Ensure that you will link this issue to your PR.

[FEATURE] Add progress bar for Drifty

Is your feature request related to a problem? Please describe.
The user gets impatient when a large file is being downloaded but the application doesn't display how much percent of the file has been downloaded / left . They simply think that the application has become unresponsive and creates a negative impact on the user.

Describe the solution you'd like
A progress bar which will show how much percentage of the file has been downloaded / left.

Additional context
Contributors who want to take over this issue should at first comment below then I will assign them with the task. Ensure that you will link this issue to your Pull Request. Multiple assignes can be there. Just leave a comment below if you are interested.

[FEATURE] JS Modification

Is your feature request related to a problem? Please describe.

No response

Describe the solution you'd like.

• Adding Downloader function for Windows and other
• Redirection for More Info
• Improving Scroll Behavior

Screenshots

No response

Additional information

No response

Remove unnecessary commands from the Readme file to get started with the project

How would you improve the documentation? Please describe.

In the For Contributers section, there is no need to use git init command. I think just forking and cloning the repo will work.

Additional information

No response

[FEATURE] Want to change the font color for the first section

Is your feature request related to a problem? Please describe.

The current color of the section is white, it is not matching with the background color. So we can change it to a darker shade.

Describe the solution you'd like.

I will change the font color to black or a darker shade of any color so that it is visible enough (when it is not in the dark mode)

Application Version

v1.1.0

Screenshots

Additional information

No response

[BUG] NumberFormatException after inputs

Exception Occur

To Reproduce
Steps to reproduce the behavior:

1. run Drifty_CLI
2. give Inputs
3. choose either Y or N
4. See error

Expected behavior
Should give download logs and Success and location of the file

Screenshots

[FEATURE] Navbar scroll

Is your feature request related to a problem? Please describe.

When you click on a link in the navbar it makes a very abrupt jump to the selected element,

Describe the solution you'd like.

I think it would look better if instead it made a vertical scroll until you reach that element.
If you agree with my proposal I can implement these changes to the project

Screenshots

No response

Additional information

No response

[FEATURE] Add heading to contact us section

Is your feature request related to a problem? Please describe.

There is no heading to the contact us section, we can add it.

Describe the solution you'd like.

I will add heading = Contact Us, as it is looking like a footer but it is a contact us section

Application Version

v1.1.0

Screenshots

No response

Additional information

No response

[FEATURE] Add social handles in the footer of the Website

Is your feature request related to a problem? Please describe.
A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]

Describe the solution you'd like
A clear and concise description of what you want to happen.

Describe alternatives you've considered
A clear and concise description of any alternative solutions or features you've considered.

Additional context
Add any other context or screenshots about the feature request here.

[OTHER] Fixing manual footer year to dynamic

Description

Footer copyright year driven manually for now
So i fixed it to dynamic one

Already created a pr #98

Application Version

v1.1.0

Additional information

Kindly Check and review @SaptarshiSarkar12

[DOCS] Enhancing/Improving the README file

How would you improve the documentation? Please describe.

Much needed grammatical improvements to the README.md file

Additional information

No response

[FEATURE] Making the hero section of the website responsive for mobiles

Is your feature request related to a problem? Please describe.

When opening the website from a smartphone or laptop, the hero section seems broken

Describe the solution you'd like.

I would like to make it responsive using flexbox so that the mobile users don't face any problem while using the website.

Application Version

v1.1.0

Screenshots

Additional information

No response

[FEATURE] Add ANSI colour similar to project logo

Add ANSI colours to the Drifty banner in the console application. The colours will be similar and matching the theme of the project logo.

[FEATURE] improve the footer links transition

Is your feature request related to a problem? Please describe.

No response

Describe the solution you'd like.

make the transition look smoother

Application Version

v1.1.0

Screenshots

No response

Additional information

No response

[FEATURE] Option to preserve original file name and extension.

Is your feature request related to a problem? Please describe.
Naming a file everytime is a bit inconvenient for me. Sometimes, I'd like to preserve the original file name. Having a default naming and manual naming option would be handy.

Describe the solution you'd like
A simple name scrap function for the file name would be preferable. This function takes a link as a String and searches for the file name (including its extension). If found, It displays and assigns the name to a variable. If this process fails, then the manual option is shown. The user can also change the file name later.

Describe alternatives you've considered
I had also thought about naming the file with the current DateTime. Since every assignment is unique, it can be a default name.

[FEATURE] Allow passing the requested parameters as program arguments

Is your feature request related to a problem? Please describe.
Currently you have to manually put in each argument as the program asks for them, this would allow inputting some or all of them as program arguments.

Describe the solution you'd like
Allow passing the various inputs it asks for as program arguments. They should be input in the same order as asked for, so link fName downloadsFolder. The program should still ask for any values not provided, or if a blank value was provided.
if downloadsFolder is y then it should try to find the default downloads folder. If it cannot find that or n was passed in then it should ask for one. If it is any other value it should be interpreted as a path. This may cause a conflict with saving to drives named y or n, I am not sure how that works exactly. If that is a problem then this could be split into two arguments, one for if a custom path should be used and a second for the custom path.

It could be worthwhile reording the arguments so that link and fName come last, which would make it easier to have a sort of 'default' downloader setup that has the downloads folder selected.

Example program arguments: https://example.com/my_file.txt "My file.txt" y which would download the file from the mentioned link and save it as My file.txt in the default downloads folder if found, asking the user for input if it cannot be found.