Convert handwritten Samsung Notes into clean, shareable PDFs automatically.
Samsung Notes exports dark-mode notes with a white background in PDFs, which can make handwritten notes difficult to read. This project automates the process of capturing notes directly from the Samsung Notes app (or scrcpy mirror), processing the images, and generating properly stitched PDF outputs with the original dark appearance preserved.
- Automated scrolling and capture of Samsung Notes
- Works with:
- Samsung Notes on Windows
- Samsung Notes mirrored through
scrcpy
- Detects page dividers using RGB color matching
- Automatically stitches screenshots into full pages
- Removes overlapping/repeating regions between captures
- Generates clean PDF exports
- Dark-mode friendly workflow
- Adjustable color tolerance and detection thresholds
- Open a note in Samsung Notes
- Run the script
- The script:
- captures screenshots
- scrolls automatically
- detects page boundaries
- stitches images together
- exports final PDFs
git clone https://github.com/alinanto/SamsungNotes2PDF.git
cd SamsungNotes2PDFpython -m venv venv
venv\Scripts\activatepython3 -m venv venv
source venv/bin/activatepip install -r requirements.txt- Python 3.10+
- Samsung Notes app or
scrcpy - A display resolution where the note area is fully visible
- Dark mode notes (recommended)
opencv-python— image processing and stitchingnumpy— pixel operationspyautogui— GUI automation and screenshotskeyboard— keyboard event handlingpynput- Handle mouse inputsimg2pdf- Handle image to pdf conversion.
Run the main script:
python salvageNotes.pyFollow the on-screen instructions.
The script may ask you to:
Change the SCREEN_REGION: If you want to adjust this region of capture (recommended for first time use) type "y" when promted, go to the the Samsung Notes window (in fullscreen and read mode configuration) and wait for 10 sec. The script will capture an screenshot and open a new window for you to select the screen region. Use mouse to select the rectangular region (avoid toolbar and scroll bar area) and then click c to confirm or r to reset.Select divider colors: By default the divider color is set to gray, but depending on your color mode it may be different for your use. When the script froms for change, press "y" and then go to the samsung Notes app and pressCtrl + Left Mouse Buttomon the divider area to select the page divider color.Confirm scrolling parameters: By default scrolling is set to half the page, you can increase this if your resolution is higher than 1980 x 1080. You might need to adjust theMAX_SEARCHandMIN_SEARCHto speed up the overlap searching function.
The script uses RGB color detection instead of arbitrary grayscale matching.
Example divider color:
RGB: (37, 37, 37)
HEX: #252525Thresholds can be adjusted in the script:
COLOR_TOL
ROW_MATCH_RATIOSamsungNotes2PDF/
│
├── main.py
├── requirements.txt
├── output/
- Requires consistent zoom level during capture
- Very large notes may take time to process
- Incorrect divider color settings can affect stitching quality
- UI changes in Samsung Notes may require parameter adjustments
Install OpenCV manually:
pip install opencv-pythonTry adjusting:
- overlap detection threshold
- scroll amount
- divider RGB tolerance
Main automation pipeline.
Responsible for:
- Capturing screenshots from Samsung Notes
- Automatically scrolling through notes
- Detecting page dividers
- Finding overlapping regions between screenshots
- Stitching screenshots into complete pages
- Exporting final PDFs
This is the primary script you run.
Merge PNG images in a folder to a pdf. The main scripts runs this at the end, but can also be used standalone.
python mergeToPdf.py
Enter image folder path: <output_folder_name>Transfers png images in one folder to another folder taking care of the file indexes in both the folders. This is usefull when you have to merge two partially generated image folders. This usually happens when the script detects blank pages in a single note or if the user input is interfering in between a scroll. Once merged you can directly call the mergeToPdf.py to merge the output png images to pdf.
python mergeFolders.py
Enter input image folder path: <input_folder_name>
Enter output image folder path: <output_folder_name>
python mergeToPdf.py
Enter image folder path: <output_folder_name>The main scripts calls this if you select yes when it promts you to change the SCREEN_REGION. It is advised to do this for the initial setup. You can also run this manually to directly get the values for SCREEN_REGION = ( x ,y , width, height ) and then edit in the main script.
Utility script for divider color selection. The main script prompts you if you want to change the divider color. if you select yes, then this script is called. You can also run this script manually to get the RBG color for yourself and edit this in the script(better for converting more than one note)
python getWinColor.pyUsed to:
- Detect RGB color values from any screen location
- Capture divider colors using:
Ctrl + Left Mouse Button
- Help configure:
TARGET_COLORCOLOR_TOL
Useful when Samsung Notes uses a different theme or divider color.
Contains all Python dependencies required for the project.
Install them using:
pip install -r requirements.txtStores generated outputs:
- stitched images
- exported PDFs
Ensure:
- display scaling is set consistently
- Samsung Notes window is fully visible
- no other window overlaps the note area
All my notes converted using this tool and avaliable here: https://hiddenlayer.ddns.net/#notes
- GUI interface
- Automatic OCR export
- Multi-note batch export
- Better overlap detection
- Direct PDF export pipeline
- Auto calibration for divider colors
Pull requests and issue reports are welcome.
If you find bugs or have ideas for improvements, open an issue on GitHub.
MIT License
Inspired by the frustration of Samsung Notes exporting dark-mode handwritten notes with white backgrounds instead of preserving the original appearance.