From b483cf5056d06e5c399a3f27ce07a32371c3d84a Mon Sep 17 00:00:00 2001 From: Guillem Hernandez Sola Date: Tue, 7 Apr 2026 19:40:01 +0200 Subject: [PATCH] Added readme --- README.md | 86 ++++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 85 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 458b3cc..a759162 100644 --- a/README.md +++ b/README.md @@ -1 +1,85 @@ -# scripts +# Scripts Repository + +A collection of utility scripts for file management, media processing, automation, Outlook handling, and more. The repository is organized by topic, with helpers for working with CSV/XLSX data, downloads, file renaming, and platform-specific tasks. + +## Repository Structure + +- `file-management/` - Scripts to process CSV and Excel files, clean contact lists, merge worksheets, and manage data exports. +- `linkedin/` - LinkedIn export and post automation helpers. +- `media/` - Downloaders, converters, and media extraction utilities for video, audio, and archives. +- `odilo/` - Scripts for working with Odilo ebook and EPUB content. +- `outlook/` - Outlook login, token retrieval, and import automation scripts. +- `pdfs/` - PDF splitting utilities. +- `replace_remove/` - File name cleanup and batch renaming scripts. +- `wordpress/` - WordPress export/article helpers. + +## Key Script Categories + +### file-management +- `buscar_grandes.sh` - Find large files. +- `filtrar_excel_per_csv.py` - Filter Excel data using a CSV file. +- `juntar_csv.py` - Join or concatenate CSV files. +- `mautic.py`, `mautic_tags.py`, `nan-mautic.py` - Mautic contact/tag management helpers. +- `netejar_desuscrits.py` - Clean unsubscribed contacts. +- `netejar_excel.py` - Clean Excel content. +- `split_excel.py` - Split Excel files into smaller files or sheets. +- `teams.py` - Teams-related export or processing script. +- `treure_etiquetes_mautic.py` - Remove Mautic tags. +- `unificar_excels.py`, `unir_excels_pestanyes.py` - Merge Excel files and worksheets. + +### linkedin +- `linkedin-posts.py` - LinkedIn post automation or export script. + +### media +- `audio-extractor.sh` - Extract audio from video. +- `convert_mp4_to_webm.sh` - Convert MP4 files to WEBM. +- `download_instagram_images.sh`, `instagram-downloader.sh`, `image-instagram-downloader.sh` - Instagram download utilities. +- `video-downloader.sh` - Download videos from URLs. +- `url-video-downloader.sh` - Download videos given URL lists. +- `webm-to-mp4-converter.sh` - Convert WEBM files to MP4. +- `zip_cbr_files.sh` - Compress files into CBR archives. +- `copy_cbr_files.sh` - Copy or manage CBR files. +- `export_instagram_cookies.py` - Export cookies for Instagram automation. +- `spotify-rss.py` - Generate RSS content for Spotify. + +### replace_remove +- `fix-all-special-characters.sh` - Normalize special characters in names. +- `remove_parentheses_files_folders.sh` - Remove parentheses from file and folder names. +- `remove_parentheses_folders.sh` - Remove parentheses from folder names. +- `replace_hyphen_with_underscores.sh` - Replace hyphens with underscores. +- `replace_spaces_with_underscores.sh` - Replace spaces with underscores. +- `replace_triple_with_underscores.sh` - Replace triple underscores patterns. +- `replace_under_hyphen_under_with_underscores.sh` - Normalize mixed underscore/hyphen patterns. + +### outlook +- `email_login.py` - Outlook email login helper. +- `get_token.py` - Retrieve Outlook authentication tokens. +- `marti.py`, `marti_import.csv`, `guillem_import.csv` - Import helpers for Outlook contact data. + +### odilo +- `biblio_odilo.py` - Odilo ebook processing script. +- `recollir_epubs.sh` - Collect EPUB files. + +### pdfs +- `split_pdf_pages.sh` - Split PDF files by page. + +### wordpress +- `export-articles.py` - Export WordPress articles. +- `agile611_posts.csv` - Example or export data. + +## Usage + +Most scripts are standalone and can be run directly from the terminal. Use `python` for `.py` scripts and `bash` or `sh` for `.sh` scripts. + +Example: + +```bash +python file-management/juntar_csv.py +bash media/video-downloader.sh +``` + +> Note: Some scripts may require additional dependencies or environment setup. Check the script header or comments for usage details. + +## Contribution + +Feel free to add new utilities, improve documentation, or organize the repository further by task area.