Merge pull request #115 from Anil-Akdeniz/master

Added Filecat

Author: canbula

Projects/filecat/README.md

@@ -0,0 +1,49 @@
+# FileCat - FTP Client / Filezilla/CyberDuck clone project with Python
+
+FileCat is a simple FTP client application built with Python and Tkinter. It allows users to connect to FTP/SFTP servers, browse remote directories, download files, and upload files or folders to the server (if permission granted). It provides a user-friendly interface for managing files and directories on remote servers.
+
+## Features
+
+- **Connect to FTP/SFTP Servers:** Enter server address, username, password, and port to connect to FTP/SFTP servers.
+- **Browse Remote Directories:** Navigate through remote directories to view files and folders.
+- **Download Files:** Double-click on a file to download it to the local system.
+- **Upload Files/Folders:** Drag and drop files or folders to upload them to the server (if permission granted).
+- **Remember Credentials:** Option to remember server credentials for future connections.
+
+## Libraries Used
+
+- **tkinter:** Standard Python interface to the Tk GUI toolkit.
+- **ftplib:** Standard Python library for FTP protocol.
+- **configparser:** Standard Python library for working with configuration files.
+- **os:** Standard Python library for interacting with the operating system.
+
+## Usage
+
+- Launch the application.
+- Enter the server address, username, password, and port.
+- Click on the "Connect" button to connect to the server.
+- Navigate through remote directories using the file explorer.
+- Double-click on a file to download it to the local system.
+- Upload files to the server (if permission granted).
+- Click on the "Disconnect" button to disconnect from the server.
+
+## Classes
+
+### filecat.py
+
+FileCatApp Class:
+   - __init__(self, master): Initializes the main application window, including all widgets and their layout.
+   - connect(self): Connects to the FTP server using the provided credentials and updates the file explorer.
+   - disconnect(self): Disconnects from the FTP server and clears the file explorer.
+   - upload_file(self): Opens a file dialog to select a file for uploading to the current directory on the server.
+
+
+### file_explorer.py
+
+ FileExplorer Class:
+   - __init__(self, master): Initializes the file explorer frame, including the tree view for displaying files and folders.
+   - update_treeview(self, files): Updates the tree view with the provided list of files and directories.
+   - change_directory(self, event=None): Changes the current directory to the specified path and updates the tree view.
+   - on_double_click(self, event): Handles double-click events on the tree view, either changing the directory or downloading a file.
+   - download_file(self, filename, server_address): Downloads the specified file from the current directory to the local system.
+   - up_directory(self): Moves up one directory level in the file explorer.

Projects/filecat/app.ico

@@ -0,0 +1,156 @@
+import tkinter as tk
+from tkinter import ttk, messagebox, PhotoImage
+import ftplib
+import os
+from datetime import datetime
+
+class FileExplorer(tk.Frame):
+    def __init__(self, master, app):
+        super().__init__(master)
+        self.app = app  # Save reference to FileCatApp instance
+        self.ftp = None 
+        self.current_path = tk.StringVar()
+
+        self.url_entry = tk.Entry(self)
+        self.url_entry.pack(fill=tk.X)
+        self.url_entry.bind("<Return>", self.change_directory)
+        
+        self.tree = ttk.Treeview(self)
+        self.tree["columns"] = ("size", "type") 
+        self.tree.heading("#0", text="Name", anchor=tk.W)
+        self.tree.heading("size", text="Size", anchor=tk.W)
+        self.tree.heading("type", text="Type", anchor=tk.W)
+        
+        self.tree.column("size", stretch=tk.YES)
+        self.tree.column("type", stretch=tk.YES)
+        self.url_frame = tk.Frame(self)
+        self.url_frame.pack(fill=tk.X)
+        self.tree.pack(expand=True, fill=tk.BOTH)
+        icon_path = os.path.join(os.path.dirname(__file__), "folder_icon.png")
+        self.folder_icon = PhotoImage(file=icon_path)
+        up_icon = PhotoImage(file="up_icon.png")
+        self.up_button = tk.Button(self.url_frame, image=up_icon, command=self.up_directory)
+        self.up_button.image = up_icon
+        self.up_button.pack(side=tk.RIGHT, padx=5, pady=5)
+        self.tree.bind("<Double-1>", self.on_double_click)
+
+        # Add delete button
+        self.delete_button = tk.Button(self.url_frame, text="Delete", command=self.delete_item)
+        self.delete_button.pack(side=tk.RIGHT, padx=5, pady=5)
+
+        # Add reconnect button
+        self.reconnect_button = tk.Button(self.url_frame, text="Reconnect", command=self.reconnect)
+        self.reconnect_button.pack(side=tk.RIGHT, padx=5, pady=5)
+
+        # Add upload button next to delete button
+        self.app.upload_button = tk.Button(self.url_frame, text="Upload", command=self.app.upload, state=tk.DISABLED)
+        self.app.upload_button.pack(side=tk.RIGHT, padx=5, pady=5)
+
+    def update_treeview(self, files):
+        self.tree.delete(*self.tree.get_children())
+        self.tree["columns"] = ("size", "type", "last_modified")
+        self.tree.heading("size", text="Size", anchor=tk.W)
+        self.tree.heading("type", text="Type", anchor=tk.W)
+        self.tree.heading("last_modified", text="Last Modified", anchor=tk.W)
+
+        directories = []
+        files_list = []
+
+        for name, details in files:
+            if details['type'] == 'dir':
+                directories.append((name, details))
+            else:
+                files_list.append((name, details))
+
+        for name, details in directories:
+            last_modified = self._format_last_modified(details.get('modify', ''))
+            self.tree.insert("", "end", text=name, open=False, image=self.folder_icon,
+                            values=("", "Directory", last_modified))
+
+        for name, details in files_list:
+            size_kb = int(details.get('size', 0)) / 1024
+            last_modified = self._format_last_modified(details.get('modify', ''))
+            self.tree.insert("", "end", values=(f"{size_kb:.2f} KB", "File", last_modified), text=name)
+    
+    def delete_item(self):
+        item_id = self.tree.selection()[0]
+        item = self.tree.item(item_id)
+        item_text = item["text"]
+
+        if messagebox.askyesno("Confirm Delete", f"Are you sure you want to delete '{item_text}'?"):
+            try:
+                if item["values"][1] == "File":
+                    self.ftp.delete(os.path.join(self.current_path.get(), item_text))
+                elif "directory" in item["tags"]:
+                    self.ftp.rmd(os.path.join(self.current_path.get(), item_text))
+                self.change_directory()
+            except ftplib.error_perm as e:
+                messagebox.showerror("Error", str(e))
+
+    def reconnect(self):
+        self.app.reconnect()  # Use the FileCatApp instance to call connect method
+    
+    def _format_last_modified(self, raw_timestamp):
+        try:
+            timestamp = datetime.strptime(raw_timestamp, "%Y%m%d%H%M%S")
+            formatted_date = timestamp.strftime("%Y-%m-%d %H:%M:%S")
+            return formatted_date
+        except ValueError:
+            return ""
+
+    def change_directory(self, event=None):
+        new_path = self.url_entry.get().strip()
+
+        new_path = new_path.replace("\\", "/")
+
+        if not new_path.startswith("/"):
+            new_path = "/" + new_path
+
+        try:
+            files = self.ftp.mlsd(new_path)
+            files = [(name, details) for name, details in files if name not in ['.', '..']]
+
+            self.current_path.set(new_path)
+            self.update_treeview(files)
+        except ftplib.error_perm as e:
+            messagebox.showerror("Error", str(e))
+
+    def on_double_click(self, event):
+        item_id = self.tree.focus()
+        item = self.tree.item(item_id)
+        item_text = item["text"]
+        item_type = item["values"][1]
+
+        if item_text != "":
+            if item_type == "Directory":
+                self.url_entry.delete(0, tk.END)
+                new_path = os.path.join(self.current_path.get(), item_text)
+                self.url_entry.insert(0, new_path)
+                self.change_directory()
+            elif item_type == "File":
+                self.download_file(item_text)
+
+    def up_directory(self):
+        current_path = self.url_entry.get().strip()
+        if current_path != "/":
+            parent_path = os.path.dirname(current_path)
+            self.url_entry.delete(0, tk.END)
+            self.url_entry.insert(0, parent_path)
+            self.change_directory()
+    
+    def download_file(self, filename):
+        remote_filename = os.path.join(self.current_path.get(), filename)
+        remote_filename = remote_filename.replace("\\", "/")
+
+        downloads_folder = os.path.join(os.getcwd(), "downloads")
+        if not os.path.exists(downloads_folder):
+            os.makedirs(downloads_folder)
+
+        local_filename = os.path.join(downloads_folder, filename)
+
+        with open(local_filename, 'wb') as local_file:
+            try:
+                self.ftp.retrbinary('RETR ' + remote_filename, local_file.write)
+                messagebox.showinfo("Download", f"{filename} downloaded successfully.")
+            except ftplib.error_perm as e:
+                messagebox.showerror("Download Error", f"Failed to download {filename}: {str(e)}")

Projects/filecat/download_icon.png

@@ -0,0 +1,142 @@
+import tkinter as tk
+from tkinter import ttk, messagebox
+import ftplib
+import configparser
+import tkinter.filedialog as filedialog
+import os
+
+from file_explorer import FileExplorer
+
+class FileCatApp:
+    def __init__(self, master):
+        self.master = master
+        self.master.title("FileCat - FTP Client")
+        self.master.geometry("800x600")
+        
+        self.connection_frame = tk.Frame(self.master)
+        self.connection_frame.pack(fill=tk.X)
+        self.upload_button = tk.Button(self.connection_frame, text="Upload", command=self.upload, state=tk.DISABLED)
+
+        tk.Label(self.connection_frame, text="Server Address:").grid(row=0, column=0, padx=5, pady=5)
+        self.server_address_entry = tk.Entry(self.connection_frame)
+        self.server_address_entry.grid(row=0, column=1, padx=5, pady=5)
+
+        tk.Label(self.connection_frame, text="Username:").grid(row=0, column=2, padx=5, pady=5)
+        self.username_entry = tk.Entry(self.connection_frame)
+        self.username_entry.grid(row=0, column=3, padx=5, pady=5)
+
+        tk.Label(self.connection_frame, text="Password:").grid(row=1, column=0, padx=5, pady=5)
+        self.password_entry = tk.Entry(self.connection_frame, show="*")
+        self.password_entry.grid(row=1, column=1, padx=5, pady=5)
+
+        tk.Label(self.connection_frame, text="Port:").grid(row=1, column=2, padx=5, pady=5)
+        self.port_entry = tk.Entry(self.connection_frame)
+        self.port_entry.grid(row=1, column=3, padx=5, pady=5)
+
+        self.remember_var = tk.IntVar(value=0)
+        self.remember_checkbox = tk.Checkbutton(self.connection_frame, text="Remember", variable=self.remember_var)
+        self.remember_checkbox.grid(row=0, column=4, rowspan=2, padx=5, pady=5)
+
+        self.connect_button = tk.Button(self.connection_frame, text="Connect", command=self.connect)
+        self.connect_button.grid(row=0, column=5, padx=5, pady=5)
+
+        self.disconnect_button = tk.Button(self.connection_frame, text="Disconnect", command=self.disconnect, state=tk.DISABLED)
+        self.disconnect_button.grid(row=0, column=6, padx=5, pady=5)
+
+        self.file_explorer = FileExplorer(self.master, self)
+        self.file_explorer.pack(expand=True, fill=tk.BOTH)
+
+        self.config = configparser.ConfigParser()
+        self.config.read("credentials.ini")
+        if "Credentials" in self.config:
+            self.server_address_entry.insert(0, self.config["Credentials"].get("ServerAddress", ""))
+            self.username_entry.insert(0, self.config["Credentials"].get("Username", ""))
+            self.password_entry.insert(0, self.config["Credentials"].get("Password", ""))
+            self.port_entry.insert(0, self.config["Credentials"].get("Port", ""))
+
+    def upload(self):
+        file_path = filedialog.askopenfilename()
+        if file_path:
+            self.upload_file(file_path)
+
+    def reconnect(self):
+        self.disconnect()
+        self.connect()
+
+    def connect(self):
+        server_address = self.server_address_entry.get()
+        username = self.username_entry.get()
+        password = self.password_entry.get()
+        port_entry = self.port_entry.get()
+
+        if port_entry:
+            try:
+                port = int(port_entry)
+            except ValueError:
+                messagebox.showerror("Connection Error", "Invalid port number.")
+                return
+        else:
+            port = 21
+
+        try:
+            ftp = ftplib.FTP()
+            ftp.connect(server_address, port)
+            ftp.login(username, password)
+
+            self.file_explorer.ftp = ftp
+
+            root_dir = "/"
+            self.file_explorer.url_entry.insert(0, root_dir)
+            self.file_explorer.change_directory()  
+            self.upload_button.config(state=tk.NORMAL)
+
+            self.disconnect_button.config(state=tk.NORMAL)
+            self.connect_button.config(state=tk.DISABLED)
+
+            if self.remember_var.get() == 1:
+                self.config["Credentials"] = {
+                    "ServerAddress": server_address,
+                    "Username": username,
+                    "Password": password,
+                    "Port": port
+                }
+                with open("credentials.ini", "w") as configfile:
+                    self.config.write(configfile)
+
+        except ftplib.all_errors as e:
+            messagebox.showerror("Connection Error", str(e))
+
+    def disconnect(self):
+        self.upload_button.config(state=tk.DISABLED)
+        if self.file_explorer.ftp:
+            self.file_explorer.ftp.quit()
+            self.file_explorer.ftp = None
+
+            self.connect_button.config(state=tk.NORMAL)
+            self.disconnect_button.config(state=tk.DISABLED)
+
+            self.file_explorer.update_treeview([])
+
+            self.file_explorer.url_entry.delete(0, tk.END)
+
+        else:
+            messagebox.showinfo("Info", "Not connected to any server.")
+
+    def upload_file(self, file_path):
+        file_name = os.path.basename(file_path)
+
+        try:
+            with open(file_path, 'rb') as file:
+                self.file_explorer.ftp.storbinary('STOR ' + file_name, file)
+                messagebox.showinfo("Upload", f"{file_name} uploaded successfully.")
+        except Exception as e:
+            messagebox.showerror("Upload Error", f"Failed to upload {file_name}: {str(e)}")
+
+def main():
+    root = tk.Tk()
+    app = FileCatApp(root)
+    root.iconbitmap("app.ico") 
+    root.mainloop()
+
+if __name__ == "__main__":
+    main()